BuildIt.CognitiveServices.FaceAPIV10Extensions.PersonAddaPersonFaceAsync C# (CSharp) Метод

PersonAddaPersonFaceAsync() публичный статический Метод

<p>Add a representative face to a person for identification. The input face is specified as an image with a targetFace rectangle. It returns a persistedFaceId representing the added face and this persistedFaceId will not expire. Note persistedFaceId is different from faceId which represents the detected face by <a href="/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236">Face - Detect</a>.</p> <ul> <li>The persistedFaceId of person is used in <a href="/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f3039523e">Person - Delete a Person Face</a> to remove a face from a person. </li> <li>Each person has a maximum of 248 faces.</li> <li>JPEG, PNG, GIF(the first frame), and BMP are supported. The image file size should be larger than or equal to 1KB but no larger than 4MB.</li> <li>The detectable face size is between 36x36 to 4096x4096 pixels. The faces out of this range will not be detected.</li> <li>Rectangle specified by targetFace should contain exactly one face. Zero or multiple faces will be regarded as an error. Out of detectable face size, large head-pose, or very large occlusions will also result in fail to add a person face.</li> <li>The given rectangle specifies both face location and face size at the same time. There is no guarantee of correct result if you are using rectangle which is not returned from <a href="/docs/services/563879b61984550e40cbbe8d/operations/563879b61984550f30395236">Face - Detect</a>. </li> </ul> <h4>Http Method</h4> POST
public static PersonAddaPersonFaceAsync ( this operations, string personGroupId, string personId, string userData = default(string), string targetFace = default(string), string subscriptionKey = default(string), string ocpApimSubscriptionKey = default(string), System cancellationToken = default(System.Threading.CancellationToken) ) : System.Threading.Tasks.Task
operations this /// The operations group for this extension method. ///
personGroupId string /// Specifying the person group containing the target person. ///
personId string /// Target person that the face is added to. ///
userData string /// User-specified data about the target face to add for any purpose. The /// maximum length is 1KB. ///
targetFace string /// A face rectangle to specify the target face to be added to a person, in /// the format of "targetFace=left,top,width,height". E.g. /// "targetFace=10,10,100,100". If there is more than one face in the image, /// targetFace is required to specify which face to add. No targetFace means /// there is only one face detected in the entire image. ///
subscriptionKey string /// subscription key in url ///
ocpApimSubscriptionKey string /// subscription key in header ///
cancellationToken System /// The cancellation token. ///
Результат System.Threading.Tasks.Task
            public static async System.Threading.Tasks.Task PersonAddaPersonFaceAsync(this IFaceAPIV10 operations, string personGroupId, string personId, string userData = default(string), string targetFace = default(string), string subscriptionKey = default(string), string ocpApimSubscriptionKey = default(string), System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))
            {
                await operations.PersonAddaPersonFaceWithHttpMessagesAsync(personGroupId, personId, userData, targetFace, subscriptionKey, ocpApimSubscriptionKey, null, cancellationToken).ConfigureAwait(false);
            }