Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Cantumkan wajah dan pengguna terkait dalam koleksi
Anda dapat menggunakan ListFacesoperasi untuk membuat daftar wajah dan pengguna terkait mereka dalam koleksi.
Untuk informasi selengkapnya, lihat Mengelola wajah dalam koleksi.
Untuk daftar wajah dalam koleksi (SDK)
-
Jika belum:
-
Buat atau perbarui pengguna dengan AmazonRekognitionFullAccess izin. Untuk informasi selengkapnya, lihat Langkah 1: Siapkan AWS akun dan buat Pengguna.
-
Instal dan konfigurasikan AWS CLI dan AWS SDKs. Untuk informasi selengkapnya, lihat Langkah 2: Siapkan AWS CLI and AWS SDKs.
-
Gunakan contoh berikut untuk memanggil operasi ListFaces.
- Java
-
Contoh ini menampilkan daftar wajah dalam koleksi.
Ubah nilai collectionId menjadi ID koleksi yang diinginkan.
//Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
//PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
package aws.example.rekognition.image;
import com.amazonaws.services.rekognition.AmazonRekognition;
import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
import com.amazonaws.services.rekognition.model.Face;
import com.amazonaws.services.rekognition.model.ListFacesRequest;
import com.amazonaws.services.rekognition.model.ListFacesResult;
import java.util.List;
import com.fasterxml.jackson.databind.ObjectMapper;
public class ListFacesInCollection {
public static final String collectionId = "MyCollection";
public static void main(String[] args) throws Exception {
AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
ObjectMapper objectMapper = new ObjectMapper();
ListFacesResult listFacesResult = null;
System.out.println("Faces in collection " + collectionId);
String paginationToken = null;
do {
if (listFacesResult != null) {
paginationToken = listFacesResult.getNextToken();
}
ListFacesRequest listFacesRequest = new ListFacesRequest()
.withCollectionId(collectionId)
.withMaxResults(1)
.withNextToken(paginationToken);
listFacesResult = rekognitionClient.listFaces(listFacesRequest);
List < Face > faces = listFacesResult.getFaces();
for (Face face: faces) {
System.out.println(objectMapper.writerWithDefaultPrettyPrinter()
.writeValueAsString(face));
}
} while (listFacesResult != null && listFacesResult.getNextToken() !=
null);
}
}
- Java V2
-
Kode ini diambil dari GitHub repositori SDK contoh AWS Dokumentasi. Lihat contoh lengkapnya di sini.
// snippet-start:[rekognition.java2.list_faces_collection.import]
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.rekognition.RekognitionClient;
import software.amazon.awssdk.services.rekognition.model.Face;
import software.amazon.awssdk.services.rekognition.model.ListFacesRequest;
import software.amazon.awssdk.services.rekognition.model.ListFacesResponse;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
import java.util.List;
// snippet-end:[rekognition.java2.list_faces_collection.import]
/**
* Before running this Java V2 code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class ListFacesInCollection {
public static void main(String[] args) {
final String usage = "\n" +
"Usage: " +
" <collectionId>\n\n" +
"Where:\n" +
" collectionId - The name of the collection. \n\n";
if (args.length < 1) {
System.out.println(usage);
System.exit(1);
}
String collectionId = args[0];
Region region = Region.US_EAST_1;
RekognitionClient rekClient = RekognitionClient.builder()
.region(region)
.credentialsProvider(ProfileCredentialsProvider.create("profile-name"))
.build();
System.out.println("Faces in collection " + collectionId);
listFacesCollection(rekClient, collectionId) ;
rekClient.close();
}
// snippet-start:[rekognition.java2.list_faces_collection.main]
public static void listFacesCollection(RekognitionClient rekClient, String collectionId ) {
try {
ListFacesRequest facesRequest = ListFacesRequest.builder()
.collectionId(collectionId)
.maxResults(10)
.build();
ListFacesResponse facesResponse = rekClient.listFaces(facesRequest);
List<Face> faces = facesResponse.faces();
for (Face face: faces) {
System.out.println("Confidence level there is a face: "+face.confidence());
System.out.println("The face Id value is "+face.faceId());
}
} catch (RekognitionException e) {
System.out.println(e.getMessage());
System.exit(1);
}
}
// snippet-end:[rekognition.java2.list_faces_collection.main]
}
- AWS CLI
-
AWS CLI Perintah ini menampilkan JSON output untuk list-faces CLI operasi. Ganti nilai collection-id dengan nama koleksi yang ingin Anda cantumkan. Ganti nilai profile_name di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda.
aws rekognition list-faces --collection-id "collection-id" --profile profile-name
- Python
-
Contoh ini menampilkan daftar wajah dalam koleksi.
Ganti nilai profile_name di baris yang membuat sesi Rekognition dengan nama profil pengembang Anda.
# Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
# PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
import boto3
def list_faces_in_collection(collection_id):
maxResults = 2
faces_count = 0
tokens = True
session = boto3.Session(profile_name='profile-name')
client = session.client('rekognition')
response = client.list_faces(CollectionId=collection_id,
MaxResults=maxResults)
print('Faces in collection ' + collection_id)
while tokens:
faces = response['Faces']
for face in faces:
print(face)
faces_count += 1
if 'NextToken' in response:
nextToken = response['NextToken']
response = client.list_faces(CollectionId=collection_id,
NextToken=nextToken, MaxResults=maxResults)
else:
tokens = False
return faces_count
def main():
collection_id = 'collection-id'
faces_count = list_faces_in_collection(collection_id)
print("faces count: " + str(faces_count))
if __name__ == "__main__":
main()
- .NET
-
Contoh ini menampilkan daftar wajah dalam koleksi.
Ubah nilai collectionId menjadi ID koleksi yang diinginkan.
//Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
//PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
using System;
using Amazon.Rekognition;
using Amazon.Rekognition.Model;
public class ListFaces
{
public static void Example()
{
String collectionId = "MyCollection";
AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
ListFacesResponse listFacesResponse = null;
Console.WriteLine("Faces in collection " + collectionId);
String paginationToken = null;
do
{
if (listFacesResponse != null)
paginationToken = listFacesResponse.NextToken;
ListFacesRequest listFacesRequest = new ListFacesRequest()
{
CollectionId = collectionId,
MaxResults = 1,
NextToken = paginationToken
};
listFacesResponse = rekognitionClient.ListFaces(listFacesRequest);
foreach(Face face in listFacesResponse.Faces)
Console.WriteLine(face.FaceId);
} while (listFacesResponse != null && !String.IsNullOrEmpty(listFacesResponse.NextToken));
}
}
ListFaces permintaan operasi
Input ke ListFaces adalah ID koleksi yang ingin Anda cantumi wajah. MaxResults adalah jumlah maksimum wajah yang dikirimkan. ListFaces juga mengambil daftar wajah IDs untuk memfilter hasilnya, dan ID pengguna yang disediakan untuk mencantumkan hanya wajah yang terkait dengan pengguna yang diberikan.
{
"CollectionId": "MyCollection",
"MaxResults": 1
}
Jika respons tersebut memiliki wajah lebih dari yang diminta oleh MaxResults, token dikembalikan sehingga Anda dapat menggunakannya untuk mendapatkan serangkaian hasil berikutnya, dalam panggilan berikutnya untuk ListFaces. Sebagai contoh:
{
"CollectionId": "MyCollection",
"NextToken": "sm+5ythT3aeEVIR4WA....",
"MaxResults": 1
}
ListFaces respon operasi
Respons dari ListFaces adalah informasi tentang metadata wajah yang disimpan dalam koleksi tertentu.
-
FaceModelVersion— Versi model wajah yang terkait dengan koleksi. Untuk informasi selengkapnya, lihat Memahami versi model.
-
Wajah — Informasi tentang wajah dalam koleksi. Ini termasuk informasi tentang BoundingBox, kepercayaan diri, pengidentifikasi gambar, dan ID wajah. Untuk informasi lebih lanjut, lihat Wajah.
-
NextToken— Token yang digunakan untuk mendapatkan set hasil berikutnya.
{
"FaceModelVersion": "6.0",
"Faces": [
{
"Confidence": 99.76940155029297,
"IndexFacesModelVersion": "6.0",
"UserId": "demoUser2",
"ImageId": "56a0ca74-1c83-39dd-b363-051a64168a65",
"BoundingBox": {
"Width": 0.03177810087800026,
"Top": 0.36568498611450195,
"Left": 0.3453829884529114,
"Height": 0.056759100407361984
},
"FaceId": "c92265d4-5f9c-43af-a58e-12be0ce02bc3"
},
{
"BoundingBox": {
"Width": 0.03254450112581253,
"Top": 0.6080359816551208,
"Left": 0.5160620212554932,
"Height": 0.06347999721765518
},
"IndexFacesModelVersion": "6.0",
"FaceId": "851cb847-dccc-4fea-9309-9f4805967855",
"Confidence": 99.94369506835938,
"ImageId": "a8aed589-ceec-35f7-9c04-82e0b546b024"
},
{
"BoundingBox": {
"Width": 0.03094629943370819,
"Top": 0.4218429923057556,
"Left": 0.6513839960098267,
"Height": 0.05266290158033371
},
"IndexFacesModelVersion": "6.0",
"FaceId": "c0eb3b65-24a0-41e1-b23a-1908b1aaeac1",
"Confidence": 99.82969665527344,
"ImageId": "56a0ca74-1c83-39dd-b363-051a64168a65"
}
]
}
