Öğretici: Yüzlerdeki canlılığı algılama

Sunucu tarafı mantığı ve yardımcı ön uç istemci uygulamalarını kullanarak yüz canlılığı algılamayı iş akışınızla tümleştirmeyi öğrenin.

Tavsiye

Yüz canlılığı algılama hakkında genel bilgi için kavramsal kılavuza bakın.

Bu öğreticide, canlılık algılaması gerçekleştirmek için bir uygulama sunucusuyla frontend uygulamasını çalıştırmak öğreneceksiniz. Ayrıca çeşitli platformlarda ve dillerde yüz doğrulama ekleyebilirsiniz.

Önemli

Yüz Tanıma için Canlılık istemcisi SDK'ları erişimi kısıtlanmış bir özelliktir. Yüz Tanıma giriş formunu doldurarak canlılık özelliğine erişim istemeniz gerekir. Azure aboneliğinize erişim verildiğinde Yüz Tanıma canlılığı SDK'sını indirebilirsiniz.

Önkoşullar

• Azure aboneliği - Ücretsiz olarak oluşturun
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Bilişsel Hizmetler Katkıda Bulunanı rolü olması gerekir. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
• Azure aboneliğinizi aldıktan sonra , anahtarınızı ve uç noktanızı almak için Azure portalında bir Yüz Tanıma kaynağı oluşturun. Dağıtıldıktan sonra Kaynağa Git seçeneğini seçin.
  • Uygulamanızı Yüz Tanıma hizmetine bağlamak için oluşturduğunuz kaynaktan anahtara ve uç noktaya ihtiyacınız vardır.
• Mobil (iOS ve Android) ve Web için Foundry Tools Face Client SDK'da Azure Vision için kısıtlı erişim gerektiren ürünlere erişim.
  • Başlamak için, geçitli yapıtlara erişim elde etmek için Yüz Tanıma Sınırlı Erişim özelliklerine başvurmanız gerekir. Daha fazla bilgi için Yüz Tanıma Sınırlı Erişim sayfasına bakın.
• Yüz canlılığı algılama özelliği hakkında bilgi. Kavramsal kılavuza bakın.

Tavsiye

Önkoşulları tamamladıktan sonra canlılık deneyimini aşağıdaki platformlarda deneyebilirsiniz:

• iOS: iOS App Store — Geliştirici modunu etkinleştirmek için yüklemeden sonra uygulama ekranına 10 kez dokunun.
  
• Android: Google Play Store — Geliştirici modunu etkinleştirmek için yüklemeden sonra uygulama ekranına 10 kez dokunun.
  
• Web: Doğrudan Vision Studio'da deneyin.
  

Ayrıca Örnekler bölümünden eksiksiz bir ön uç örneği (iOS, Android veya Web) derleyebilir ve çalıştırabilirsiniz.

Ön uç uygulamasını hazırlama

SDK'lar, ön uç uygulamanızla tümleştirmeyi basitleştirmek için birden çok dilde kullanılabilir. Kullanıcı arabirimini ve gerekli kodun entegrasyonunu sağlamak için aşağıdaki bölümlerde seçtiğiniz SDK'nın README dosyasına bakın.

Önemli

Her ön yüz SDK'sının başarıyla derlenmesi için kısıtlı bir varlığa erişimi gerekmektedir. Bu erişimi ayarlamak için aşağıdaki yönergelere bakın.

Swift iOS için:

• Belirteçler: iOS için Azure Yüz Tanıma UI SDK
• API başvurusu: AzureAIVisionFaceUI Başvurusu
• Örnek: iOS örneği

Kotlin/Java Android için:

• Artefaktlar: Maven Central: com.azure:azure-ai-vision-face-ui
• API referansı: azure-ai-vision-face-ui Referansı
• Örnek: Android örneği

JavaScript Web için:

• Artifaktlar: @azure/ai-vision-face-ui - npm
• API başvurusu: AzureAIVisionFaceUI Başvurusu
• Örnek: Web örneği
• Çerçeve Desteği: React (Next.jsdahil), Vue.jsve Angular gibi popüler çerçevelerle çalışır.

Sdk, ön uç uygulamanızla tümleştirildikten sonra kamerayı başlatır, kullanıcıya konumunu ayarlaması için yol gösterir, canlılık yükünü oluşturur ve işlenmek üzere Azure Yüz Tanıma hizmetine gönderir.

Yeni SDK sürüm güncelleştirmeleri için deponun Sürümler bölümünü izleyin ve GitHub Dependabot (GitHub depoları için) veya Renovate (GitHub, GitLab, Bitbucket, Azure Repos) gibi otomatik bağımlılık güncelleştirme uyarılarını etkinleştirin.

Canlılık algılaması yap

Aşağıdaki adımlarda canlılık düzenleme işlemi açıklanmaktadır:

1. Ön uç uygulaması canlılık denetimini başlatır ve uygulama sunucusuna bildirir.

2. Uygulama sunucusu, Azure Yüz Tanıma Servisi ile yeni bir canlı oturum oluşturur. Servis bir etkinlik oturumu oluşturur ve bir oturum yetkilendirme jetonu ile yanıt verir. Canlılık oturumu oluştururken kullanılan her istek parametresi hakkında daha fazla bilgi için bkz. Canlılık Oluşturma Oturumu İşlemi.

   C#

   var endpoint = new Uri(System.Environment.GetEnvironmentVariable("FACE_ENDPOINT"));
   var key = new AzureKeyCredential(System.Environment.GetEnvironmentVariable("FACE_APIKEY"));
   
   var body = JsonSerializer.Serialize(new
   {
       livenessOperationMode = "PassiveActive",
       deviceCorrelationId = "723d6d03-ef33-40a8-9682-23a1feb7bccd",
       enableSessionImage = true
   });
   
   using var client = new HttpClient();
   client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", key);
   
   var response = await client.PostAsync(
       $"{endpoint}/face/v1.2/detectLiveness-sessions",
       new StringContent(body, Encoding.UTF8, "application/json"));
   
   response.EnsureSuccessStatusCode();
   
   using var doc  = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
   var root       = doc.RootElement;
   
   Console.WriteLine("Session created");
   Console.WriteLine($"sessionId : {root.GetProperty("sessionId").GetString()}");
   Console.WriteLine($"authToken : {root.GetProperty("authToken").GetString()}");
   

   Java

   String endpoint = System.getenv("FACE_ENDPOINT");
   String key = System.getenv("FACE_APIKEY");
   
   String body = """
   {
       "livenessOperationMode": "PassiveActive",
       "deviceCorrelationId": "723d6d03-ef33-40a8-9682-23a1feb7bccd",
       "enableSessionImage": true,
   }
   """;
   
   HttpRequest req = HttpRequest.newBuilder()
           .uri(URI.create(endpoint + "/face/v1.2/detectLiveness-sessions"))
           .header("Content-Type", "application/json")
           .header("Ocp-Apim-Subscription-Key", key)
           .POST(HttpRequest.BodyPublishers.ofString(body))
           .build();
   
   HttpResponse<String> res = HttpClient.newHttpClient()
           .send(req, HttpResponse.BodyHandlers.ofString());
   
   if (res.statusCode() != 200) throw new RuntimeException("HTTP error: " + res.statusCode());
   
   JsonNode json = new ObjectMapper().readTree(res.body());
   System.out.println("Session created");
   System.out.println("sessionId : " + json.get("sessionId").asText());
   System.out.println("authToken : " + json.get("authToken").asText());
   

   Python

   endpoint = os.environ["FACE_ENDPOINT"]
   key = os.environ["FACE_APIKEY"]
   
   url  = f"{endpoint}/face/v1.2/detectLiveness-sessions"
   body = {
       "livenessOperationMode": "PassiveActive",
       "deviceCorrelationId":  "723d6d03-ef33-40a8-9682-23a1feb7bccd",
       "enableSessionImage":   True
   }
   
   headers = {
       "Ocp-Apim-Subscription-Key": key,
       "Content-Type": "application/json"
   }
   
   res = requests.post(url, headers=headers, data=json.dumps(body))
   res.raise_for_status()
   
   data = res.json()
   print("Session created")
   print("sessionId :", data["sessionId"])
   print("authToken :", data["authToken"])
   

   JavaScript

   const endpoint = process.env['FACE_ENDPOINT'];
   const apikey = process.env['FACE_APIKEY'];
   
   const url  = `${endpoint}/face/v1.2/detectLiveness-sessions`;
   const body = {
       livenessOperationMode: "PassiveActive",
       deviceCorrelationId:  "723d6d03-ef33-40a8-9682-23a1feb7bccd",
       enableSessionImage:   true
   };
   
   const headers = {
       "Ocp-Apim-Subscription-Key": key,
       "Content-Type": "application/json"
   };
   
   async function createLivenessSession() {
       const res = await fetch(url, {
           method: "POST",
           headers,
           body: JSON.stringify(body)
       });
   
       if (!res.ok) {
           throw new Error(`${res.status} ${await res.text()}`);
       }
   
       const data = await res.json();
       console.log("Session created");
       console.log("sessionId :", data.sessionId);
       console.log("authToken :", data.authToken);
   }
   

   REST API (Windows)

   curl --request POST --location "%FACE_ENDPOINT%/face/v1.2/detectLiveness-sessions" ^
   --header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%" ^
   --header "Content-Type: application/json" ^
   --data ^
   "{ ^
       ""livenessOperationMode"": ""passiveactive"", ^
       ""deviceCorrelationId"": ""723d6d03-ef33-40a8-9682-23a1feb7bccd"", ^
       ""enableSessionImage"": ""true"" ^
   }"
   

   REST API (Linux)

   curl --request POST --location "${FACE_ENDPOINT}/face/v1.2/detectLivenesswithVerify-sessions" \
   --header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}" \
   --header "Content-Type: application/json" \
   --data \
   '{
       "livenessOperationMode": "passiveactive",
       "deviceCorrelationId": "723d6d03-ef33-40a8-9682-23a1feb7bccd",
       "enableSessionImage": "true"
   }'
   

   Yanıt gövdesi örneği:

   {
       "sessionId": "a6e7193e-b638-42e9-903f-eaf60d2b40a5",
       "authToken": "<session-authorization-token>",
       "status": "NotStarted",
       "modelVersion": "2025-05-20",
       "results": {
           "attempts": []
       }
   }
   

3. Uygulama sunucusu, oturum yetkilendirme belirtecini ön uç uygulamasına geri sağlar.

4. Ön uç uygulaması, canlılık akışını başlatan yüz canlılığı algılayıcısını başlatmak için oturum yetkilendirme belirtecini kullanır.

   Android

       FaceLivenessDetector(
           sessionAuthorizationToken = FaceSessionToken.sessionToken,
           verifyImageFileContent = FaceSessionToken.sessionSetInClientVerifyImage,
           deviceCorrelationId = "null",
           onSuccess = viewModel::onSuccess,
           onError = viewModel::onError
       )
   

   Ios

   struct HostView: View {
      @State var livenessDetectionResult: LivenessDetectionResult? = nil
      var token: String
      var body: some View {
          if livenessDetectionResult == nil {
              FaceLivenessDetectorView(result: $livenessDetectionResult,
                                       sessionAuthorizationToken: token)
          } else if let result = livenessDetectionResult {
              VStack {
                  switch result { 
                      case .success(let success):
                      /// <#show success#>
                      case .failure(let error):
                      /// <#show failure#>
                  }
              }
          }
      }
   }
   

   Web

   faceLivenessDetector = document.createElement("azure-ai-vision-face-ui");
   document.getElementById("container").appendChild(faceLivenessDetector);
   faceLivenessDetector.start(session.authToken)
   

5. SDK kamerayı başlatır, kullanıcıyı doğru konumlandırması için yönlendirir ve ardından yükü canlılık algılama hizmet uç noktasını çağırmak için hazırlar.

6. SDK, canlılık algılamasını gerçekleştirmek için Azure Görüntü İşleme Yüz Tanıma hizmetini çağırır. Hizmet yanıt verdiği zaman SDK, ön uç uygulamasına canlılık denetiminin tamamlandığını bildirir. Hizmet yanıtı canlılık kararını içermez. Bu bilgileri uygulama sunucusundan sorgula.

7. Ön uç uygulaması, canlılık denetimi tamamlama işlemini uygulama sunucusuna aktarır.

8. Uygulama sunucusu, Azure Görüntü İşleme Yüz Tanıma hizmetinden gelen canlılık algılama sonucunu sorgular.

   C#

   using var client = new HttpClient();
   client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", key);
   
   var response = await client.GetAsync(
       $"{endpoint}/face/v1.2/livenessSessions/{sessionId}/result");
   
   response.EnsureSuccessStatusCode();
   
   using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
   var root = doc.RootElement;
   var attempts = root.GetProperty("results").GetProperty("attempts");
   var latestAttempt = attempts[attempts.GetArrayLength() - 1];
   var attemptStatus = latestAttempt.GetProperty("attemptStatus").GetString();
   
   Console.WriteLine($"Session id: {root.GetProperty("sessionId").GetString()}");
   Console.WriteLine($"Session status: {root.GetProperty("status").GetString()}");
   Console.WriteLine($"Latest attempt status: {attemptStatus}");
   
   if (attemptStatus == "Succeeded")
       Console.WriteLine($"Liveness detection decision: {latestAttempt.GetProperty("result").GetProperty("livenessDecision").GetString()}");
   else
   {
       var error = latestAttempt.GetProperty("error");
       Console.WriteLine($"Error: {error.GetProperty("code").GetString()} - {error.GetProperty("message").GetString()}");
   }
   

   Java

   HttpRequest req = HttpRequest.newBuilder()
       .uri(URI.create(endpoint + "/face/v1.2/livenessSessions/" + sessionId + "/result"))
       .header("Ocp-Apim-Subscription-Key", key)
       .GET()
       .build();
   
   HttpResponse<String> res = HttpClient.newHttpClient()
       .send(req, HttpResponse.BodyHandlers.ofString());
   
   if (res.statusCode() != 200) throw new RuntimeException("HTTP error: " + res.statusCode());
   
   JsonNode root = new ObjectMapper().readTree(res.body());
   JsonNode attempts = root.path("results").path("attempts");
   JsonNode latestAttempt = attempts.get(attempts.size() - 1);
   
   String attemptStatus = latestAttempt.path("attemptStatus").asText();
   
   System.out.println("Session id: " + root.path("sessionId").asText());
   System.out.println("Session status: " + root.path("status").asText());
   System.out.println("Latest attempt status: " + attemptStatus);
   
   if ("Succeeded".equals(attemptStatus)) {
       System.out.println("Liveness detection decision: " +
           latestAttempt.path("result").path("livenessDecision").asText());
   } else {
       JsonNode error = latestAttempt.path("error");
       System.out.println("Error: " + error.path("code").asText() + " - " +
           error.path("message").asText());
   }
   

   Python

   url = f"{endpoint}/face/v1.2/livenessSessions/{sessionId}/result"
   headers = { "Ocp-Apim-Subscription-Key": key }
   
   res = requests.get(url, headers=headers)
   res.raise_for_status()
   
   data = res.json()
   attempts = data["results"]["attempts"]
   latest_attempt = attempts[-1]
   attempt_status = latest_attempt.get("attemptStatus")
   
   print(f"Session id: {data['sessionId']}")
   print(f"Session status: {data['status']}")
   print(f"Latest attempt status: {attempt_status}")
   
   if attempt_status == "Succeeded":
       print(f"Liveness detection decision: {latest_attempt['result']['livenessDecision']}")
   else:
       err = latest_attempt.get("error", {})
       print(f"Error: {err.get('code')} - {err.get('message')}")
   

   JavaScript

   const url = `${endpoint}/face/v1.2/livenessSessions/${sessionId}/result`;
   const headers = {
       "Ocp-Apim-Subscription-Key": apikey
   };
   
   async function getLivenessSessionResult() {
       const res = await fetch(url, { method: "GET", headers });
       if (!res.ok) {
           throw new Error(`${res.status} ${await res.text()}`);
       }
   
       const data = await res.json();
       const attempts = data.results.attempts;
       const latestAttempt = attempts[attempts.length - 1];
       const attemptStatus = latestAttempt.attemptStatus;
   
       console.log("Session id :", data.sessionId);
       console.log("Session status :", data.status);
       console.log("Latest attempt status :", attemptStatus);
   
       if (attemptStatus === "Succeeded") {
           console.log("Liveness detection decision :", latestAttempt.result.livenessDecision);
       } else {
               const err = latestAttempt.error || {};
               console.log(`Error: ${err.code} - ${err.message}`);
       }
   }
   

   REST API (Windows)

   curl --request GET --location "%FACE_ENDPOINT%/face/v1.2/detectLiveness-sessions/<session-id>" ^
   --header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"
   

   REST API (Linux)

   curl --request GET --location "${FACE_ENDPOINT}/face/v1.2/detectLiveness-sessions/<session-id>" \
   --header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"
   

   Yanıt gövdesi örneği:

   {
       "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
       "authToken": "eyJhbGciOiJFUzI1NiIsIm",
       "status": "NotStarted",
       "modelVersion": "2024-11-15",
       "results": {
           "attempts": [
               {
                   "attemptId": 2,
                   "attemptStatus": "Succeeded",
                   "result": {
                   "livenessDecision": "realface",
                   "targets": {
                       "color": {
                       "faceRectangle": {
                               "top": 669,
                               "left": 203,
                               "width": 646,
                               "height": 724
                           }
                       }
                   },
                   "digest": "B0A803BB7B26F3C8F29CD36030F8E63ED3FAF955FEEF8E01C88AB8FD89CCF761",
                   "sessionImageId": "Ae3PVWlXAmVAnXgkAFt1QSjGUWONKzWiSr2iPh9p9G4I"
                   }
               },
               {
                   "attemptId": 1,
                   "attemptStatus": "Failed",
                   "error": {
                   "code": "FaceWithMaskDetected",
                   "message": "Mask detected on face image.",
                   "targets": {
                           "color": {
                           "faceRectangle": {
                               "top": 669,
                               "left": 203,
                               "width": 646,
                               "height": 724
                           }
                           }
                       }
                   }
               }
           ]
       }
   }
   

9. Uygulama sunucusu, tüm oturum sonuçlarını sorguladıktan sonra oturumu siler.

   C#

   using var client = new HttpClient();
   client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", key);
   
   await client.DeleteAsync($"{endpoint}/face/v1.2/livenessSessions/{sessionId}");
   Console.WriteLine($"Session deleted: {sessionId}");
   

   Java

   HttpRequest req = HttpRequest.newBuilder()
       .uri(URI.create(endpoint + "/face/v1.2/livenessSessions/" + sessionId))
       .header("Ocp-Apim-Subscription-Key", key)
       .DELETE()
       .build();
   
   HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
   System.out.println("Session deleted: " + sessionId);
   

   Python

   headers = { "Ocp-Apim-Subscription-Key": key }
   requests.delete(f"{endpoint}/face/v1.2/livenessSessions/{sessionId}", headers=headers)
   print(f"Session deleted: {sessionId}")
   

   JavaScript

   const headers = { "Ocp-Apim-Subscription-Key": apikey };
   await fetch(`${endpoint}/face/v1.2/livenessSessions/${sessionId}`, { method: "DELETE", headers });
   console.log(`Session deleted: ${sessionId}`);
   

   REST API (Windows)

   curl --request DELETE --location "%FACE_ENDPOINT%/face/v1.2/detectLiveness-sessions/<session-id>" ^
   --header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"
   

   REST API (Linux)

   curl --request DELETE --location "${FACE_ENDPOINT}/face/v1.2/detectLiveness-sessions/<session-id>" \
   --header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"
   

Canlılık algılamasını yüz doğrulama ile gerçekleştir.

Yüz doğrulamayı canlılık algılama ile birleştirmek, ilgili kişinin sistemde fiziksel olarak bulunduğuna ilişkin ek bir garanti ile biyometrik doğrulamayı sağlar.

Canlılık algılamayı doğrulama ile tümleştirmek iki bölümden oluşur:

1. Adım - Referans görüntüsü seçme

En doğru tanıma sonuçlarını almak için kimlik doğrulama senaryoları için oluşturma gereksinimlerinde listelenen ipuçlarını izleyin.

2. Adım - Doğrulama ile canlılık düzenlemesini ayarlama

Aşağıdaki üst düzey adımlar doğrulama ile canlılığı düzenlemeyi gösterir:

1. Aşağıdaki iki yöntemden birini kullanarak doğrulama başvuru görüntüsünü sağlayın:

   • Uygulama sunucusu, canlılık oturumu oluştururken referans görüntüsünü sağlar. Her istek parametresi hakkında ayrıntılı bilgi için Doğrulama ile Canlılık Oturumu Oluşturma İşlemi bölümüne bakın.

     C#

     var endpoint = new Uri(System.Environment.GetEnvironmentVariable("FACE_ENDPOINT"));
     var key      = System.Environment.GetEnvironmentVariable("FACE_APIKEY");
     
     // Create the JSON part
     var jsonPart = new StringContent(
         JsonSerializer.Serialize(new
         {
             livenessOperationMode = "PassiveActive",
             deviceCorrelationId = "723d6d03-ef33-40a8-9682-23a1feb7bcc",
             enableSessionImage = true
         }),
         Encoding.UTF8,
         "application/json"
     );
     jsonPart.Headers.ContentDisposition = new ContentDispositionHeaderValue("form-data")
     {
         Name = "CreateLivenessWithVerifySessionRequest"
     };
     
     // Create the file part
     using var fileStream = File.OpenRead("test.png");
     var filePart = new StreamContent(fileStream);
     filePart.Headers.ContentType = new MediaTypeHeaderValue("image/png");
     filePart.Headers.ContentDisposition = new ContentDispositionHeaderValue("form-data")
     {
         Name = "VerifyImage",
         FileName = "test.png"
     };
     
     // Build multipart form data
     using var formData = new MultipartFormDataContent();
     formData.Add(jsonPart);
     formData.Add(filePart);
     
     using var client = new HttpClient();
     client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", key);
     
     var response = await client.PostAsync($"{endpoint}/face/v1.2/createLivenessWithVerifySession", formData);
     response.EnsureSuccessStatusCode();
     
     using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
     var root = doc.RootElement;
     
     Console.WriteLine("Session created.");
     Console.WriteLine($"Session id: {root.GetProperty("sessionId").GetString()}");
     Console.WriteLine($"Auth token: {root.GetProperty("authToken").GetString()}");
     

     Java

     String endpoint = System.getenv("FACE_ENDPOINT");
     String key      = System.getenv("FACE_APIKEY");
     
     String json = """
     {
     "livenessOperationMode": "PassiveActive",
     "deviceCorrelationId": "723d6d03-ef33-40a8-9682-23a1feb7bcc",
     "enableSessionImage": true
     }
     """;
     
     byte[] img = Files.readAllBytes(Path.of("test.png"));
     String boundary = "----faceBoundary" + java.util.UUID.randomUUID();
     
     var head =
         "--" + boundary + "\r\n" +
         "Content-Disposition: form-data; name=\"CreateLivenessWithVerifySessionRequest\"\r\n" +
         "Content-Type: application/json\r\n\r\n" +
         json + "\r\n" +
         "--" + boundary + "\r\n" +
         "Content-Disposition: form-data; name=\"VerifyImage\"; filename=\"test.png\"\r\n" +
         "Content-Type: image/png\r\n\r\n";
     
     var tail = "\r\n--" + boundary + "--\r\n";
     
     byte[] body = java.nio.ByteBuffer
         .allocate(head.getBytes(StandardCharsets.UTF_8).length + img.length + tail.getBytes(StandardCharsets.UTF_8).length)
         .put(head.getBytes(StandardCharsets.UTF_8))
         .put(img)
         .put(tail.getBytes(StandardCharsets.UTF_8))
         .array();
     
     HttpRequest req = HttpRequest.newBuilder()
         .uri(URI.create(endpoint + "/face/v1.2/createLivenessWithVerifySession"))
         .header("Ocp-Apim-Subscription-Key", key)
         .header("Content-Type", "multipart/form-data; boundary=" + boundary)
         .POST(HttpRequest.BodyPublishers.ofByteArray(body))
         .build();
     
     HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
     if (res.statusCode() != 200) throw new RuntimeException("HTTP error: " + res.statusCode());
     
     JsonNode root = new ObjectMapper().readTree(res.body());
     System.out.println("Session created.");
     System.out.println("Session id: " + root.get("sessionId").asText());
     System.out.println("Auth token: " + root.get("authToken").asText());
     

     Python

     endpoint = os.environ["FACE_ENDPOINT"]
     key      = os.environ["FACE_APIKEY"]
     
     url = f"{endpoint}/face/v1.2/createLivenessWithVerifySession"
     files = {
         "CreateLivenessWithVerifySessionRequest": (
             "request.json",
             json.dumps({
                 "livenessOperationMode": "PassiveActive",
                 "deviceCorrelationId": "723d6d03-ef33-40a8-9682-23a1feb7bcc",
                 "enableSessionImage": True
             }),
             "application/json"
         ),
         "VerifyImage": ("test.png", open("test.png", "rb"), "image/png")
     }
     headers = { "Ocp-Apim-Subscription-Key": key }
     
     res = requests.post(url, headers=headers, files=files)
     res.raise_for_status()
     
     data = res.json()
     print("Session created.")
     print("Session id:", data["sessionId"])
     print("Auth token:", data["authToken"])
     

     JavaScript

     const endpoint = process.env["FACE_ENDPOINT"];
     const apikey   = process.env["FACE_APIKEY"];
     
     const form = new FormData();
     form.append(
         "CreateLivenessWithVerifySessionRequest",
         new Blob([JSON.stringify({
             livenessOperationMode: "PassiveActive",
             deviceCorrelationId: "723d6d03-ef33-40a8-9682-23a1feb7bcc",
             enableSessionImage: true
         })], { type: "application/json" }),
         "request.json"
     );
     // If your runtime doesn't support Blob here, you can use fs.createReadStream instead.
     form.append("VerifyImage", new Blob([fs.readFileSync("test.png")], { type: "image/png" }), "test.png");
     
     const res = await fetch(`${endpoint}/face/v1.2/createLivenessWithVerifySession`, {
         method: "POST",
         headers: { "Ocp-Apim-Subscription-Key": apikey },
         body: form
     });
     if (!res.ok) {
         throw new Error(`${res.status} ${await res.text()}`);
     }
     
     const data = await res.json();
     console.log("Session created.");
     console.log("Session id:", data.sessionId);
     console.log("Auth token:", data.authToken);
     

     REST API (Windows)

     curl --request POST --location "%FACE_ENDPOINT%/face/v1.2/detectLivenesswithVerify-sessions" ^
     --header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%" ^
     --form "Parameters=""{\\\""livenessOperationMode\\\"": \\\""passiveactive\\\"", \\\""deviceCorrelationId\\\"": \\\""723d6d03-ef33-40a8-9682-23a1feb7bccd\\\"", ""enableSessionImage"": ""true""}""" ^
     --form "VerifyImage=@""test.png"""
     

     REST API (Linux)

     curl --request POST --location "${FACE_ENDPOINT}/face/v1.2/detectLivenesswithVerify-sessions" \
     --header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}" \
     --form 'Parameters="{
         \"livenessOperationMode\": \"passiveactive\",
         \"deviceCorrelationId\": \"723d6d03-ef33-40a8-9682-23a1feb7bccd\"
     }"' \
     --form 'VerifyImage=@"test.png"'
     

     Yanıt gövdesi örneği:

     {
         "sessionId": "3847ffd3-4657-4e6c-870c-8e20de52f567",
         "authToken": "<session-authorization-token>",
         "status": "NotStarted",
         "modelVersion": "2024-11-15",
         "results": {
             "attempts": [],
             "verifyReferences": [
             {
                 "referenceType": "image",
                 "faceRectangle": {
                 "top": 98,
                 "left": 131,
                 "width": 233,
                 "height": 300
                 },
                 "qualityForRecognition": "high"
             }
             ]
         }
     }
     

   • Ön uç uygulaması, mobil SDK'ları başlatırken başvuru görüntüsünü sağlar. Bu senaryo web çözümünde desteklenmez.

     Android

         FaceLivenessDetector(
             sessionAuthorizationToken = FaceSessionToken.sessionToken,
             verifyImageFileContent = FaceSessionToken.sessionSetInClientVerifyImage,
             deviceCorrelationId = "null",
             onSuccess = viewModel::onSuccess,
             onError = viewModel::onError
         )
     

     Ios

     struct HostView: View {
         @State var livenessDetectionResult: LivenessDetectionResult? = nil
         var token: String
         var body: some View {
             if livenessDetectionResult == nil {
                 FaceLivenessDetectorView(result: $livenessDetectionResult,
                                             sessionAuthorizationToken: token)
             } else if let result = livenessDetectionResult {
                 VStack {
                     switch result { 
                         case .success(let success):
                         /// <#show success#>
                         case .failure(let error):
                         /// <#show failure#>
                     }
                 }
             }
         }
     }
     

     Web

     Not supported.
     

2. Uygulama sunucusu artık canlılık sonucuna ek olarak doğrulama sonucunu sorgulayabilir.

   C#

   using var client = new HttpClient();
   client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", key);
   
   var response = await client.GetAsync($"{endpoint}/face/v1.2/livenessSessions/{sessionId}/result");
   response.EnsureSuccessStatusCode();
   
   using var doc = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
   var root = doc.RootElement;
   
   var attempts = root.GetProperty("results").GetProperty("attempts");
   var latestAttempt = attempts[attempts.GetArrayLength() - 1];
   var attemptStatus = latestAttempt.GetProperty("attemptStatus").GetString();
   
   Console.WriteLine($"Session id: {root.GetProperty("sessionId").GetString()}");
   Console.WriteLine($"Session status: {root.GetProperty("status").GetString()}");
   Console.WriteLine($"Latest attempt status: {attemptStatus}");
   
   if (attemptStatus == "Succeeded")
   {
       var decision = latestAttempt.GetProperty("result").GetProperty("livenessDecision").GetString();
       var verify   = latestAttempt.GetProperty("verifyResult");
       Console.WriteLine($"Liveness detection decision: {decision}");
       Console.WriteLine($"Verify isIdentical: {verify.GetProperty("isIdentical").GetBoolean()}");
       Console.WriteLine($"Verify matchConfidence: {verify.GetProperty("matchConfidence").GetDouble()}");
   }
   else
   {
       var err = latestAttempt.GetProperty("error");
       Console.WriteLine($"Error: {err.GetProperty("code").GetString()} - {err.GetProperty("message").GetString()}");
   }
   

   Java

   HttpRequest req = HttpRequest.newBuilder()
       .uri(URI.create(endpoint + "/face/v1.2/livenessSessions/" + sessionId + "/result"))
       .header("Ocp-Apim-Subscription-Key", key)
       .GET()
       .build();
   
   HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
   if (res.statusCode() != 200) throw new RuntimeException("HTTP error: " + res.statusCode());
   
   ObjectMapper om = new ObjectMapper();
   JsonNode root = om.readTree(res.body());
   
   JsonNode attempts = root.path("results").path("attempts");
   JsonNode latest   = attempts.get(attempts.size() - 1);
   String attemptStatus = latest.path("attemptStatus").asText();
   
   System.out.println("Session id: " + root.path("sessionId").asText());
   System.out.println("Session status: " + root.path("status").asText());
   System.out.println("Latest attempt status: " + attemptStatus);
   
   if ("Succeeded".equals(attemptStatus)) {
       String decision = latest.path("result").path("livenessDecision").asText();
       JsonNode verify = latest.path("verifyResult");
       System.out.println("Liveness detection decision: " + decision);
       System.out.println("Verify isIdentical: " + verify.path("isIdentical").asBoolean());
       System.out.println("Verify matchConfidence: " + verify.path("matchConfidence").asDouble());
   } else {
       JsonNode err = latest.path("error");
       System.out.println("Error: " + err.path("code").asText() + " - " + err.path("message").asText());
   }
   

   Python

   url = f"{endpoint}/face/v1.2/livenessSessions/{sessionId}/result"
   headers = {"Ocp-Apim-Subscription-Key": key}
   
   res = requests.get(url, headers=headers)
   res.raise_for_status()
   
   data = res.json()
   attempts = data["results"]["attempts"]
   latest = attempts[-1]
   attempt_status = latest.get("attemptStatus")
   
   print(f"Session id: {data['sessionId']}")
   print(f"Session status: {data['status']}")
   print(f"Latest attempt status: {attempt_status}")
   
   if attempt_status == "Succeeded":
       decision = latest["result"]["livenessDecision"]
       verify   = latest.get("verifyResult", {})
       print(f"Liveness detection decision: {decision}")
       print(f"Verify isIdentical: {verify.get('isIdentical')}")
       print(f"Verify matchConfidence: {verify.get('matchConfidence')}")
   else:
       err = latest.get("error", {})
       print(f"Error: {err.get('code')} - {err.get('message')}")
   

   JavaScript

   const url = `${endpoint}/face/v1.2/livenessSessions/${sessionId}/result`;
   const headers = { "Ocp-Apim-Subscription-Key": apikey };
   
   async function getLivenessWithVerifyResult() {
   const res = await fetch(url, { method: "GET", headers });
   if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
   
   const data = await res.json();
   const attempts = data.results.attempts;
   const latest = attempts[attempts.length - 1];
   const attemptStatus = latest.attemptStatus;
   
   console.log("Session id:", data.sessionId);
   console.log("Session status:", data.status);
   console.log("Latest attempt status:", attemptStatus);
   
   if (attemptStatus === "Succeeded") {
       console.log("Liveness detection decision:", latest.result.livenessDecision);
       console.log("Verify isIdentical:", latest.verifyResult?.isIdentical);
       console.log("Verify matchConfidence:", latest.verifyResult?.matchConfidence);
   } else {
       const err = latest.error || {};
       console.log(`Error: ${err.code} - ${err.message}`);
   }
   }
   

   REST API (Windows)

   curl --request GET --location "%FACE_ENDPOINT%/face/v1.2/detectLivenesswithVerify-sessions/<session-id>" ^
   --header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"
   

   REST API (Linux)

   curl --request GET --location "${FACE_ENDPOINT}/face/v1.2/detectLivenesswithVerify-sessions/<session-id>" \
   --header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"
   

   Yanıt gövdesi örneği:

   {
       "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
       "authToken": "eyJhbGciOiJFUzI1NiIsIm",
       "status": "NotStarted",
       "modelVersion": "2024-11-15",
       "results": {
           "attempts": [
           {
               "attemptId": 2,
               "attemptStatus": "Succeeded",
               "result": {
               "livenessDecision": "realface",
               "targets": {
                   "color": {
                   "faceRectangle": {
                       "top": 669,
                       "left": 203,
                       "width": 646,
                       "height": 724
                   }
                   }
               },
               "verifyResult": {
                   "matchConfidence": 0.08871888,
                   "isIdentical": false
               },
               "digest": "B0A803BB7B26F3C8F29CD36030F8E63ED3FAF955FEEF8E01C88AB8FD89CCF761",
               "sessionImageId": "Ae3PVWlXAmVAnXgkAFt1QSjGUWONKzWiSr2iPh9p9G4I",
               "verifyImageHash": "43B7D8E8769533C3290DBD37A84D821B2C28CB4381DF9C6784DBC4AAF7E45018"
               }
           },
           {
               "attemptId": 1,
               "attemptStatus": "Failed",
               "error": {
                   "code": "FaceWithMaskDetected",
                   "message": "Mask detected on face image.",
                   "targets": {
                       "color": {
                       "faceRectangle": {
                               "top": 669,
                               "left": 203,
                               "width": 646,
                               "height": 724
                           }
                       }
                   }
               }
           }
           ],
           "verifyReferences": [
               {
                   "referenceType": "image",
                   "faceRectangle": {
                   "top": 316,
                   "left": 131,
                   "width": 498,
                   "height": 677
                   },
                   "qualityForRecognition": "high"
               }
           ]
           }
       }
   

3. Artık sonucuna ihtiyacınız yoksa uygulama sunucusu oturumu silebilir.

   C#

   using var client = new HttpClient();
   client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", key);
   
   await client.DeleteAsync($"{endpoint}/face/v1.2/livenessWithVerifySessions/{sessionId}");
   Console.WriteLine($"Liveness-with-Verify session deleted: {sessionId}");
   

   Java

   HttpRequest req = HttpRequest.newBuilder()
       .uri(URI.create(endpoint + "/face/v1.2/livenessWithVerifySessions/" + sessionId))
       .header("Ocp-Apim-Subscription-Key", key)
       .DELETE()
       .build();
   
   HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
   System.out.println("Liveness-with-Verify session deleted: " + sessionId);
   

   Python

   headers = { "Ocp-Apim-Subscription-Key": key }
   requests.delete(f"{endpoint}/face/v1.2/livenessWithVerifySessions/{sessionId}", headers=headers)
   print(f"Liveness-with-Verify session deleted: {sessionId}")
   

   JavaScript

   const headers = { "Ocp-Apim-Subscription-Key": apikey };
   await fetch(`${endpoint}/face/v1.2/livenessWithVerifySessions/${sessionId}`, { method: "DELETE", headers });
   console.log(`Liveness-with-Verify session deleted: ${sessionId}`);
   

   REST API (Windows)

   curl --request DELETE --location "%FACE_ENDPOINT%/face/v1.2/detectLivenesswithVerify-sessions/<session-id>" ^
   --header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"
   

   REST API (Linux)

   curl --request DELETE --location "${FACE_ENDPOINT}/face/v1.2/detectLivenesswithVerify-sessions/<session-id>" \
   --header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"
   

Canlılık algılamadan sonra diğer yüz işlemlerini gerçekleştir

İsteğe bağlı olarak, canlılık denetiminden sonra yüz analizi (yüz özniteliklerini almak için) ve yüz kimliği işlemleri gibi ek yüz işlemleri gerçekleştirebilirsiniz.

1. parametresi enableSessionImagetrue "Oturum Oluşturma" adımı sırasında ayarlayın.
2. sessionImageId öğesini çıkarın.
3. Diğer yüz analizi veya yüz kimliği işlemlerine devam etmek için oturum görüntüsünü indirin (Liveness Get Session Image Operation API içinde referans verilmiştir), veya sessionImageId işleminde kimliğini sağlayın. Bu işlemler hakkında daha fazla bilgi için bkz . Yüz algılama kavramları ve Yüz Tanıma kavramları.

Destek seçenekleri

Main Foundry Tools destek seçeneklerini kullanmanın yanı sıra, sorularınızı SDK deposunun issues bölümüne de gönderebilirsiniz.

İlgili içerik

Mevcut uygulamanıza canlılık çözümünü entegre etmeyi öğrenmek için Azure Vision SDK Referansı'na bakınız.

• Kotlin (Android)
• Swift (iOS)
• JavaScript (Web)

Canlılık çözümünü düzenlemeye yönelik özellikler hakkında daha fazla bilgi edinmek için Oturum REST API referansına bakın.

• Canlılık Oturumu İşlemleri