Faces インターフェイス

パッケージ:

com.microsoft.azure.cognitiveservices.vision.faceapi

public interface Faces

このクラスのインスタンスは、Faces で定義されているすべての操作へのアクセスを提供します。

メソッドの概要

修飾子と型	メソッドと説明
FacesDetectWithStreamDefinitionStages.WithImage	detectWithStream() 画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。
List<DetectedFace>	detectWithStream(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) 画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。
Observable<List<DetectedFace>>	detectWithStreamAsync(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) 画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。
FacesDetectWithUrlDefinitionStages.WithUrl	detectWithUrl() 画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。
List<DetectedFace>	detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) 画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。
Observable<List<DetectedFace>>	detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) 画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。
FacesFindSimilarDefinitionStages.WithFaceId	findSimilar() クエリ顔の faceId を指定し、faceId 配列または faceListId から類似した顔を見つけます。
List<SimilarFace>	findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) クエリ顔の faceId を指定し、faceId 配列または faceListId から類似した顔を見つけます。
Observable<List<SimilarFace>>	findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) クエリ顔の faceId を指定し、faceId 配列または faceListId から類似した顔を見つけます。
GroupResult	group(List<UUID> faceIds) 顔の類似性に基づいて候補の顔をグループ分けします。
Observable<GroupResult>	groupAsync(List<UUID> faceIds) 顔の類似性に基づいて候補の顔をグループ分けします。
FacesIdentifyDefinitionStages.WithPersonGroupId	identify() 個人グループから不明な顔を識別します。
List<IdentifyResult>	identify(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) 個人グループから不明な顔を識別します。
Observable<List<IdentifyResult>>	identifyAsync(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) 個人グループから不明な顔を識別します。
VerifyResult	verifyFaceToFace(UUID faceId1, UUID faceId2) 2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。
Observable<VerifyResult>	verifyFaceToFaceAsync(UUID faceId1, UUID faceId2) 2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。
VerifyResult	verifyFaceToPerson(UUID faceId, String personGroupId, UUID personId) 2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します。
Observable<VerifyResult>	verifyFaceToPersonAsync(UUID faceId, String personGroupId, UUID personId) 2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します。

メソッドの詳細

detectWithStream

public FacesDetectWithStreamDefinitionStages.WithImage detectWithStream()

画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。

Returns:

detectWithStream 呼び出しの最初のステージ

detectWithStream

public List detectWithStream(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter)

画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。

Parameters:

image - イメージ ストリーム。

detectWithStreamOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

成功した場合は DetectedFace> オブジェクトを一覧表示<します。

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

APIErrorException - 要求がサーバーによって拒否された場合にスローされる

RuntimeException - 要求の送信に失敗した場合、他のすべてのラップされたチェック例外

detectWithStreamAsync

public Observable> detectWithStreamAsync(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter)

画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。

Parameters:

image - イメージ ストリーム。

detectWithStreamOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

List<DetectedFace> オブジェクトに対して監視可能な

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

detectWithUrl

public FacesDetectWithUrlDefinitionStages.WithUrl detectWithUrl()

画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。

Returns:

detectWithUrl 呼び出しの最初のステージ

detectWithUrl

public List detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。

Parameters:

url - イメージのパブリックに到達可能な URL。

detectWithUrlOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

成功した場合は DetectedFace> オブジェクトを一覧表示<します。

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

APIErrorException - 要求がサーバーによって拒否された場合にスローされる

RuntimeException - 要求の送信に失敗した場合、他のすべてのラップされたチェック例外

detectWithUrlAsync

public Observable> detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

画像内の人間の顔を検出し、顔の位置を返し、必要に応じて faceId、ランドマーク、属性を使用します。

Parameters:

url - イメージのパブリックに到達可能な URL。

detectWithUrlOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

List<DetectedFace> オブジェクトに対して監視可能な

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

findSimilar

public FacesFindSimilarDefinitionStages.WithFaceId findSimilar()

クエリ顔の faceId を指定し、faceId 配列または faceListId から類似した顔を見つけます。

Returns:

findSimilar 呼び出しの最初のステージ

findSimilar

public List findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

クエリ顔の faceId を指定し、faceId 配列または faceListId から類似した顔を見つけます。

Parameters:

faceId - クエリ顔の FaceId。 有効な faceId を取得するには、ユーザーが Face - Detect first を呼び出す必要があります。 この faceId は永続化されず、検出呼び出しの 24 時間後に期限切れになることに注意してください。

findSimilarOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

成功した場合は、SimilarFace> オブジェクトを一覧表示<します。

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

APIErrorException - 要求がサーバーによって拒否された場合にスローされる

RuntimeException - 要求の送信に失敗した場合、他のすべてのラップされたチェック例外

findSimilarAsync

public Observable> findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

クエリ顔の faceId を指定し、faceId 配列または faceListId から類似した顔を見つけます。

Parameters:

faceId - クエリ顔の FaceId。 有効な faceId を取得するには、ユーザーが Face - Detect first を呼び出す必要があります。 この faceId は永続化されず、検出呼び出しの 24 時間後に期限切れになることに注意してください。

findSimilarOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

List<SimilarFace> オブジェクトに対して監視可能な

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

group

public GroupResult group(List faceIds)

顔の類似性に基づいて候補の顔をグループ分けします。

Parameters:

faceIds - Face - Detect によって作成された候補 faceId の配列。 最大は 1,000 面です。

Returns:

成功した場合は GroupResult オブジェクト。

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

APIErrorException - 要求がサーバーによって拒否された場合にスローされる

RuntimeException - 要求の送信に失敗した場合、他のすべてのラップされたチェック例外

groupAsync

public Observable groupAsync(List faceIds)

顔の類似性に基づいて候補の顔をグループ分けします。

Parameters:

faceIds - Face - Detect によって作成された候補 faceId の配列。 最大は 1,000 面です。

Returns:

GroupResult オブジェクトに対して監視可能な

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

identify

public FacesIdentifyDefinitionStages.WithPersonGroupId identify()

個人グループから不明な顔を識別します。

Returns:

識別呼び出しの最初のステージ

identify

public List identify(String personGroupId, List faceIds, IdentifyOptionalParameter identifyOptionalParameter)

個人グループから不明な顔を識別します。

Parameters:

personGroupId - PersonGroups.Create によって作成されたターゲットユーザー グループの PersonGroupId。

faceIds - Face - Detect によって作成されたクエリ顔 faceId の配列。 各顔は個別に識別されます。 有効な faceId の数は [1, 10] の間です。

identifyOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

成功した場合は、IdentifyResult> オブジェクトを一覧表示<します。

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

APIErrorException - 要求がサーバーによって拒否された場合にスローされる

RuntimeException - 要求の送信に失敗した場合、他のすべてのラップされたチェック例外

identifyAsync

public Observable> identifyAsync(String personGroupId, List faceIds, IdentifyOptionalParameter identifyOptionalParameter)

個人グループから不明な顔を識別します。

Parameters:

personGroupId - PersonGroups.Create によって作成されたターゲットユーザー グループの PersonGroupId。

faceIds - Face - Detect によって作成されたクエリ顔 faceId の配列。 各顔は個別に識別されます。 有効な faceId の数は [1, 10] の間です。

identifyOptionalParameter - この API を呼び出す前に設定する省略可能なパラメーターを表す オブジェクト

Returns:

List<IdentifyResult> オブジェクトに対して監視可能な

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

verifyFaceToFace

public VerifyResult verifyFaceToFace(UUID faceId1, UUID faceId2)

2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。

Parameters:

faceId1 - 最初の顔の FaceId は、Face - Detect から取得されます。

faceId2 - 2 番目の顔の FaceId は、Face - Detect から取得されます。

Returns:

成功した場合は VerifyResult オブジェクト。

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

APIErrorException - 要求がサーバーによって拒否された場合にスローされる

RuntimeException - 要求の送信に失敗した場合、他のすべてのラップされたチェック例外

verifyFaceToFaceAsync

public Observable verifyFaceToFaceAsync(UUID faceId1, UUID faceId2)

2 つの顔が同一人物に属しているか 1 つの顔が 1 人の人物に属しているかを確認します。

Parameters:

faceId1 - 最初の顔の FaceId は、Face - Detect から取得されます。

faceId2 - 2 番目の顔の FaceId は、Face - Detect から取得されます。

Returns:

VerifyResult オブジェクトに対して監視可能な

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

verifyFaceToPerson

public VerifyResult verifyFaceToPerson(UUID faceId, String personGroupId, UUID personId)

2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します。

Parameters:

faceId - FaceId 顔は、Face - Detect から取得されます。

personGroupId - 既存の personGroupId と personId を使用して、指定されたユーザーを高速に読み込む。 personGroupId は Person Groups.Create に作成されます。

personId - ユーザー グループ内の特定のユーザーを指定します。 personId は Persons.Create で作成されます。

Returns:

成功した場合は VerifyResult オブジェクト。

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる

APIErrorException - 要求がサーバーによって拒否された場合にスローされる

RuntimeException - 要求の送信に失敗した場合、他のすべてのラップされたチェック例外

verifyFaceToPersonAsync

public Observable verifyFaceToPersonAsync(UUID faceId, String personGroupId, UUID personId)

2 つの顔が同じ人物に属しているかどうかを確認します。 顔 ID と人物 ID を比較します。

Parameters:

faceId - FaceId 顔は、Face - Detect から取得されます。

personGroupId - 既存の personGroupId と personId を使用して、指定されたユーザーを高速に読み込む。 personGroupId は Person Groups.Create に作成されます。

personId - ユーザー グループ内の特定のユーザーを指定します。 personId は Persons.Create で作成されます。

Returns:

VerifyResult オブジェクトに対して監視可能な

Throws:

IllegalArgumentException - パラメーターが検証に失敗した場合にスローされる