Arama Kaydına genel bakış

Makale
05/21/2024

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:

Kaydedilmekte olan bir çağrıyı gösteren diyagram.

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.

Arama kayıt mimarisini gösteren diyagram.

İş 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

Kanal Türü	İçerik Biçimi	Çözüm	Örnekleme Oranı	Bit hızı	Veri hızı	Çıktı	Açıklama
karma	mp4	1920x1080, 16 FPS (saniyede kare)	16 kHz	1 mb/sn	7,5 MB/dk*	tek dosya, tek kanal	Görünen ad desteğiyle varsayılan 3x3 (en etkin hoparlörler) kutucuğu düzenlemesinde karma video

Ses

Kanal Türü	İçerik Biçimi	Örnekleme Oranı	Bit hızı	Veri hızı	Çıktı	Açıklama
karma	Mp3	16 kHz	48 kb/sn	0,36 MB/dk*	tek dosya, tek kanal	tüm katılımcıların karışık sesi
karma	Wav	16 kHz	256 kb/sn	1,92 MB/dk	tek dosya, tek kanal	tüm katılımcıların karışık sesi
karışık değil	Wav	16 kHz	256 kb/sn	Kanal başına 1,92 MB/dk*	tek dosya, en fazla 5 wav kanalı	karışık ses, kanal başına bir katılımcı, en fazla beş kanal

[*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.

İşlem	Üzerinde Çalışır	Açıklamalar
Kaydı Başlat	`serverCallId`	Döndürür `recordingId`
Kayıt Durumunu Alma	`recordingId`	Döndürür `RecordingStateResult`
Kaydı Duraklat	`recordingId`	Arama kaydını duraklatma ve sürdürme, bir aramanın veya toplantının bir kısmını kaydetmeyi atlamanıza ve kaydı tek bir dosyada sürdürmenize olanak tanır.
Kaydı Sürdür	`recordingId`	Duraklatılmış kayıt işlemini sürdürür. İçerik, duraklatmadan önceki içerikle aynı dosyaya eklenir.
Kaydı Durdur	`recordingId`	Kaydı durdurur ve dosya indirme için son medya işlemeyi başlatır.

Event Grid bildirimleri

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

Not

Azure İletişim Hizmetleri, kayıtlar için kısa vadeli medya depolama alanı sağlar. Kayıtlar 24 saat boyunca indirilebilir. 24 saat sonra kayıtlar artık kullanılamaz.

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
                                     }
                    },
  "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

Arama Kaydı'nı kullanmaya başlayın.

İ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.

Aracılığıyla paylaş