Skip to content

Commit c5f6162

Browse files
committed
integrate nabil's tutorial edits
1 parent 676da06 commit c5f6162

File tree

1 file changed

+10
-31
lines changed
  • articles/ai-services/computer-vision/tutorials

1 file changed

+10
-31
lines changed

articles/ai-services/computer-vision/tutorials/liveness.md

Lines changed: 10 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -31,15 +31,15 @@ This tutorial demonstrates how to operate a frontend application and an app serv
3131
- Once you have your Azure subscription, <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesFace" title="Create a Face resource" target="_blank">create a Face resource</a> in the Azure portal to get your key and endpoint. After it deploys, select **Go to resource**.
3232
- You need the key and endpoint from the resource you create to connect your application to the Face service.
3333
- You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
34-
- Access to the Azure AI Vision Face Client SDK for mobile (IOS and Android) and web. To get started, you need to apply for the [Face Recognition Limited Access features](https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUQjA5SkYzNDM4TkcwQzNEOE1NVEdKUUlRRCQlQCN0PWcu) to get access to the SDK. For more information, see the [Face Limited Access](/legal/cognitive-services/computer-vision/limited-access-identity?context=%2Fazure%2Fcognitive-services%2Fcomputer-vision%2Fcontext%2Fcontext) page.
34+
- Access to the Azure AI Vision Face Client SDK for Mobile (IOS and Android) and Web. To get started, you need to apply for the [Face Recognition Limited Access features](https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUQjA5SkYzNDM4TkcwQzNEOE1NVEdKUUlRRCQlQCN0PWcu) to get access to the SDK. For more information, see the [Face Limited Access](/legal/cognitive-services/computer-vision/limited-access-identity?context=%2Fazure%2Fcognitive-services%2Fcomputer-vision%2Fcontext%2Fcontext) page.
3535

36-
## Set up frontend applications and app servers to perform liveness detection
36+
## Prepare SDKs
3737

38-
We provide SDKs in different languages for frontend applications and app servers. See the following instructions to set up your frontend applications and app servers.
38+
We provide SDKs in different languages to simplify development on frontend applications and app servers.
3939

4040
### Download SDK for frontend application
4141

42-
Once you have access to the SDK, follow instructions in the [azure-ai-vision-sdk](https://github.com/Azure-Samples/azure-ai-vision-sdk) GitHub repository to integrate the UI and the code into your native mobile application. The liveness SDK supports Java/Kotlin for Android mobile applications, Swift for iOS mobile applications and JavaScript for web applications:
42+
Follow instructions in the [azure-ai-vision-sdk](https://github.com/Azure-Samples/azure-ai-vision-sdk) GitHub repository to integrate the UI and the code into your native mobile application. The liveness SDK supports Java/Kotlin for Android mobile applications, Swift for iOS mobile applications and JavaScript for web applications:
4343
- For Swift iOS, follow the instructions in the [iOS sample](https://aka.ms/azure-ai-vision-face-liveness-client-sdk-ios-readme)
4444
- For Kotlin/Java Android, follow the instructions in the [Android sample](https://aka.ms/azure-ai-vision-face-liveness-client-sdk-android-readme)
4545
- For JavaScript Web, follow the instructions in the [Web sample](https://aka.ms/azure-ai-vision-face-liveness-client-sdk-web-readme)
@@ -59,9 +59,9 @@ The app server/orchestrator is responsible for controlling the lifecycle of a li
5959
- For Python, follow the instructions in the [Python readme](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/face/azure-ai-vision-face/README.md)
6060
- For JavaScript, follow the instructions in the [JavaScript readme](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/face/ai-vision-face-rest/README.md)
6161

62-
### Create environment variables
62+
> [!IMPORTANT]
63+
> To create environment variables for your Azure Face service key and endpoint, see the [quickstart](../quickstarts-sdk/identity-client-library.md)
6364
64-
[!INCLUDE [create environment variables](../includes/face-environment-variables.md)]
6565

6666
## Perform liveness detection
6767

@@ -402,27 +402,12 @@ There are two parts to integrating liveness with verification:
402402

403403
:::image type="content" source="../media/liveness/liveness-verify-diagram.jpg" alt-text="Diagram of the liveness-with-face-verification workflow of Azure AI Face." lightbox="../media/liveness/liveness-verify-diagram.jpg":::
404404

405-
### Select a reference image
405+
### Step 1 - Select a reference image
406406

407-
Use the following tips to ensure that your input images give the most accurate recognition results.
407+
Follow the tips listed in the [composition requirements for ID verification scenarios](../overview-identity.md#input-requirements) to ensure that your input images give the most accurate recognition results.
408408

409-
#### Technical requirements
410-
[!INCLUDE [identity-input-technical](../includes/identity-input-technical.md)]
411-
* You can utilize the `qualityForRecognition` attribute in the [face detection](../how-to/identity-detect-faces.md) operation when using applicable detection models as a general guideline of whether the image is likely of sufficient quality to attempt face recognition on. Only `"high"` quality images are recommended for person enrollment and quality at or above `"medium"` is recommended for identification scenarios.
412409

413-
#### Composition requirements
414-
- Photo is clear and sharp, not blurry, pixelated, distorted, or damaged.
415-
- Photo is not altered to remove face blemishes or face appearance.
416-
- Photo must be in an RGB color supported format (JPEG, PNG, WEBP, BMP). Recommended Face size is 200 pixels x 200 pixels. Face sizes larger than 200 pixels x 200 pixels will not result in better AI quality, and no larger than 6 MB in size.
417-
- User is not wearing glasses, masks, hats, headphones, head coverings, or face coverings. Face should be free of any obstructions.
418-
- Facial jewelry is allowed provided they do not hide your face.
419-
- Only one face should be visible in the photo.
420-
- Face should be in neutral front-facing pose with both eyes open, mouth closed, with no extreme facial expressions or head tilt.
421-
- Face should be free of any shadows or red eyes. Retake photo if either of these occur.
422-
- Background should be uniform and plain, free of any shadows.
423-
- Face should be centered within the image and fill at least 50% of the image.
424-
425-
### Set up the orchestration of liveness with verification.
410+
### Step 2 - Set up the orchestration of liveness with verification.
426411

427412
The high-level steps involved in liveness with verification orchestration are illustrated below:
428413
1. Providing the verification reference image by either of the following two methods:
@@ -806,20 +791,14 @@ Yes, you can.
806791
- You can now either download the session-image (referenced in [Liveness Get Session Image Operation](/rest/api/face/liveness-session-operations/get-session-image)), or provide "sessionImageId" in the [/detect](/rest/api/face/face-detection-operations/detect-from-session-image-id) operation to continue to perform other face analysis or face identity operations (referenced in [Concept Face Detection](../concept-face-detection.md) and [Concept Face Recognition](../concept-face-recognition.md)).
807792

808793

809-
## Clean up resources
810-
811-
If you want to clean up and remove an Azure AI services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
812-
813-
* [Azure portal](../../multi-service-resource.md?pivots=azportal#clean-up-resources)
814-
* [Azure CLI](../../multi-service-resource.md?pivots=azcli#clean-up-resources)
815794

816795
## Support options
817796

818797
In addition to using the main [Azure AI services support options](../../cognitive-services-support-options.md), you can also post your questions in the [issues](https://github.com/Azure-Samples/azure-ai-vision-sdk/issues) section of the SDK repo.
819798
820799
## Related content
821800

822-
To learn about other options in the liveness APIs, see the Azure AI Vision SDK reference.
801+
To learn how to integrate the liveness solution into your existing application, see the Azure AI Vision SDK reference.
823802

824803
- [Kotlin (Android)](https://aka.ms/azure-ai-vision-face-liveness-client-sdk-android-readme)
825804
- [Swift (iOS)](https://aka.ms/azure-ai-vision-face-liveness-client-sdk-ios-readme)

0 commit comments

Comments
 (0)