Arama Kaydına genel bakış

Arama Kaydı, kaydı başlatmak, durdurmak, duraklatmak ve sürdürmek için size bir dizi API sağlayarak Azure İletişim Hizmetleri'de kullanılabilen birden çok arama senaryosu kaydetmenizi sağlar. PSTN, WebRTC veya SIP çağrısı olsun, bu API'lere sunucu tarafı iş mantığınızdan erişilebilir. Ayrıca, kayıtlar sunucu uygulamasına kaydı başlatmasını söyleyen bir kullanıcı eylemi tarafından tetiklenebilir.

İş gereksinimlerinize bağlı olarak, farklı Azure İletişim Hizmetleri çağrı uygulamaları için Çağrı Kaydı'nı kullanabilirsiniz.

Örneğin, 1:1 veya 1:N sesli ve görüntülü aramaları kaydedebilirsiniz:

Arama Otomasyonu tarafından yönetilen karmaşık PSTN veya VoIP gelen ve giden arama iş akışlarını kaydetmek için Arama Kaydı'nı da kullanabilirsiniz.

Çağrı Kaydı, aramayı nasıl oluşturduğunuzdan bağımsız olarak, yerleşik geçici depolama alanında 24 saat boyunca depolanan karma veya karışık olmayan medya dosyaları üretmenizi sağlar. Dosyaları alabilir, kendi Azure Blob Store Kendi Depolama Getir'inize veya istediğiniz bir depolama çözümüne taşıyabilirsiniz. Çağrı Kaydı tüm Azure İletişim Hizmetleri veri bölgelerini destekler.

İş gereksinimlerinizi destekleyen Arama Kaydı

Arama Kaydı, iş gereksinimlerinizi ve kullanım durumlarınızı karşılamak için birden çok medya çıkışını ve içerik türünü destekler. Kayıtları tutma, toplantı notları, koçluk ve eğitim, hatta uyumluluk ve bağlılık gibi senaryolar için karma biçimler kullanabilirsiniz. Alternatif olarak, kalite güvencesi kullanım örneklerini veya gelişmiş analiz veya yapay zeka tabanlı (Yapay Zeka) gelişmiş çağrı sonrası işlemler gibi daha karmaşık senaryoları ele almak için karışık ses biçimini kullanabilirsiniz.

Video

Ses

[*NOT] Mp3 ve Mp4 biçimleri, değişken bit hızına neden olan kayıplı sıkıştırma kullanır; bu nedenle, önceki tablolardaki veri hızı değerleri teorik üst sınırı yansıtır. WAV biçimi sıkıştırılmamıştır ve bit hızı sabittir, bu nedenle veri hızı hesaplamaları tam olarak yapılır.

Arama Kaydı API'lerimiz ile kayıtlarınız üzerinde tam denetime sahip olun

Grup araması oluşturan ve konuşmayı kaydeden bir uygulama gibi iç iş mantığı tetikleyicileri aracılığıyla kaydı yönetmek için Arama Kaydı API'lerini kullanabilirsiniz. Ayrıca, kayıtlar sunucu uygulamasına kaydı başlatmasını söyleyen bir kullanıcı eylemi tarafından tetiklenebilir. Çağrı Kaydı API'leri kaydı başlatmak için yalnızca öğesini serverCallId kullanır. 'yi nasıl edineceğinizi serverCallIdöğrenmek için Arama Kaydı Hızlı Başlangıcımızı gözden geçirin. recordingId Kayıt başlatıldığında döndürülür ve bu işlem duraklatma ve sürdürme gibi takip işlemleri için kullanılabilir.

Event Grid bildirimleri

Arama Kaydı, size medya ve meta verilerle ilgili bildirimler sağlamak için Azure Event Grid'i kullanır.

Bir kayıt alınmaya hazır olduğunda, genellikle toplantı sona erdiğinde veya kayıt durdurulduktan birkaç dakika sonra Event Grid bildirimi Microsoft.Communication.RecordingFileStatusUpdated yayımlanır. Kayıt olayı bildirimleri, hem kaydedilen medyayı hem de bir kayıt meta veri dosyasını almak için kullanılan ve metadataLocationdeğerlerini içerircontentLocation.

Bildirim Şeması Başvurusu

{
    "id": string, // Unique guid for event
    "topic": string, // /subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/Microsoft.Communication/communicationServices/{communication-services-resource-name}
    "subject": string, // /recording/call/{call-id}/serverCallId/{serverCallId}/recordingId/{recordingId}
    "data": {
        "recordingStorageInfo": {
            "recordingChunks": [
                {
                    "documentId": string, // Document id for retrieving from storage
                    "index": int, // Index providing ordering for this chunk in the entire recording
                    "endReason": string, // Reason for chunk ending: "SessionEnded", "ChunkMaximumSizeExceeded”, etc.
                    "metadataLocation": <string>,  // url of the metadata for this chunk
                    "contentLocation": <string>,   // url of the mp4, mp3, or wav for this chunk
                    "deleteLocation": <string>     // url of the mp4, mp3, or wav to delete this chunk
                }
            ]
        },
        "recordingStartTime": string, // ISO 8601 date time for the start of the recording
        "recordingDurationMs": int, // Duration of recording in milliseconds
        "sessionEndReason": string // Reason for call ending: "CallEnded", "InitiatorLeft", etc.
    },
    "eventType": string, // "Microsoft.Communication.RecordingFileStatusUpdated"
    "dataVersion": string, // "1.0"
    "metadataVersion": string, // "1"
    "eventTime": string // ISO 8601 date time for when the event was created
}

Meta Veri Şeması Başvurusu

{
  "resourceId": <string>,           // stable resource id of the Azure Communication Services resource recording
  "callId": <string>,               // id of the call
  "chunkDocumentId": <string>,      // object identifier for the chunk this metadata corresponds to
  "chunkIndex": <number>,           // index of this chunk with respect to all chunks in the recording
  "chunkStartTime": <string>,       // ISO 8601 datetime for the start time of the chunk this metadata corresponds to
  "chunkDuration": <number>,        // [Chunk duration has a maximum of 4 hours] duration of the chunk this metadata corresponds to in milliseconds
  "pauseResumeIntervals": [
              "startTime": <string>,          // ISO 8601 datetime for the time at which the recording was paused
              "duration": <number>            // duration of the pause in the recording in milliseconds
                          ],
  "recordingInfo": {
               "contentType": <string>,        // content type of recording, e.g. audio/audioVideo
               "channelType": <string>,        // channel type of recording, e.g. mixed/unmixed
               "format": <string>,             // format of the recording, e.g. mp4/mp3/wav
               "audioConfiguration": {
                   "sampleRate": <number>,       // sample rate for audio recording
                   "bitRate": <number>,          // bitrate for audio recording
                   "channels": <number>          // number of audio channels in output recording
                                     },
               "videoConfiguration": {
                   "longerSideLength": <number>,        // longerSideLength for video recording
                   "shorterSideLength": <number>,       // shorterSideLength for video recording
                   "frameRate": <number>,               // frameRate for video recording
                   "bitRate": <number>                  // bitrate for video recording
                                     }
                    },
  "participants": [
    {
      "participantId": <string>,    // participant identifier of a participant captured in the recording
      "channel": <number>           // channel the participant was assigned to if the recording is unmixed
    }
  ]
}

Mevzuat ve gizlilikle ilgili endişeler

Birçok ülke/bölge ve eyalet, arama kaydı için geçerli olan yasa ve düzenlemelere sahiptir. PSTN, sesli ve görüntülü aramalar genellikle kullanıcıların iletişimlerinin kaydedilmesine onay vermelerini gerektirir. Arama kaydı özelliklerini yasalara uygun olarak kullanmak sizin sorumluluğunuzdadır. Her katılımcı için geçerli yasalara uygun bir şekilde kaydedilen iletişim süreçlerinin tüm taraflarından izin almalısınız.

Kişisel verilerin bakımıyla ilgili düzenlemeler, kullanıcı verilerini dışarı aktarabilmeyi gerektirir. Bu gereksinimleri desteklemek için meta veri dosyalarını kaydetmek, dizideki her çağrı katılımcısının öğesini participants içerirparticipantId. Aramadaki katılımcıları tanımlamak için dizideki participants Azure İletişim Hizmetleri Kullanıcı Kimliğine iç kullanıcı kimliklerinizle çapraz başvuruda bulunabilirsiniz.

Sonraki adımlar

İlginizi çekecek bazı makaleler şunlardır:

• Arama kaydı Analizler ve Günlükler hakkında daha fazla bilgi edinin
• Çağrı Otomasyonu hakkında daha fazla bilgi edinin.
• Görüntülü Arama hakkında daha fazla bilgi edinin.