Přehled záznamu hovoru

  • Článek

Poznámka:

Funkce Nahrávání hovorů pro interoperabilitu Teams je teď ve verzi Public Preview.

Záznam volání umožňuje zaznamenávat více scénářů volání dostupných ve službě Azure Communication Services tím, že poskytuje sadu rozhraní API pro spuštění, zastavení, pozastavení a obnovení nahrávání. Bez ohledu na to, jestli se jedná o volání přes veřejnou telefonní síť, WebRTC nebo SIP, můžou být tato rozhraní API přístupná z obchodní logiky na straně serveru. Nahrávky se dají aktivovat také akcí uživatele, která serverové aplikaci řekne, aby spustila nahrávání.

V závislosti na vašich obchodních potřebách můžete použít záznam volání pro různé implementace volání služeb Azure Communication Services. Můžete například nahrát audio a videohovory 1:1 nebo 1:N:

Diagram showing a call that it's being recorded.

Záznam volání ale můžete použít také k zaznamenání složitých pracovních postupů příchozích a odchozích volání přes veřejnou telefonní síť nebo VoIP spravovaných automatizací volání. Bez ohledu na to, jak jste hovor vytvořili, vám záznam hovoru umožňuje vytvářet smíšené nebo nemixované mediální soubory, které jsou uloženy po dobu 48 hodin v integrovaném dočasném úložišti. Soubory můžete načíst a převést je do dlouhodobého řešení úložiště podle vašeho výběru. Záznam volání podporuje všechny oblasti dat služeb Azure Communication Services.

Diagram showing call recording architecture.

Záznam hovoru, který podporuje vaše obchodní potřeby

Záznam hovoru podporuje více multimediálních výstupů a typů obsahu pro řešení obchodních potřeb a případů použití. Můžete použít smíšené formáty pro scénáře, jako je uchovávání záznamů, poznámek ze schůzek, koučování a školení nebo dokonce dodržování předpisů a dodržování předpisů. Nebo můžete použít nemixovaný formát zvuku k řešení případů použití záruky kvality nebo ještě složitějších scénářů, jako jsou pokročilé analýzy nebo umělé inteligence (umělá inteligence) sofistikované procesy po volání.

Video

Typ kanálu Formát obsahu Rozlišení Vzorkovací frekvence Přenosová rychlost Rychlost dat Výstup Popis
kombinované mp4 1920x1080, 16 FPS (snímky za sekundu) 16 kHz 1 mb/s 7,5 MB/min* jeden soubor, jeden kanál smíšené video ve výchozím uspořádání dlaždic 3x3 (většina aktivních reproduktorů) s podporou zobrazovaného názvu

Zvuk

Typ kanálu Formát obsahu Vzorkovací frekvence Přenosová rychlost Rychlost dat Výstup Popis
kombinované Mp3 16 kHz 48 kB/s 0,36 MB/min* jeden soubor, jeden kanál smíšený zvuk všech účastníků
kombinované Wav 16 kHz 256 kb/s 1,92 MB/min jeden soubor, jeden kanál smíšený zvuk všech účastníků
Nesmíšené Wav 16 kHz 256 kb/s 1,92 MB/min* na kanál jeden soubor, až 5 kanálů wav nemixovaný zvuk, jeden účastník na kanál, až pět kanálů

[*POZNÁMKA] Formáty Mp3 a Mp4 používají ztrátovou kompresi, která má za následek proměnlivou přenosovou rychlost; hodnoty datové rychlosti v tabulkách výše odrážejí teoretickou maximální hodnotu. Formát WAV je nekomprimovaný a přenosová rychlost je pevná, takže výpočty rychlosti dat jsou přesné.

Získejte úplnou kontrolu nad svými nahrávkami pomocí našich rozhraní API pro záznam hovorů.

Rozhraní API pro záznam hovorů se dají použít ke správě záznamu prostřednictvím interních triggerů obchodní logiky, jako je například aplikace, která vytváří skupinový hovor a nahrává konverzaci. Nahrávky se dají aktivovat také akcí uživatele, která serverové aplikaci řekne, aby spustila nahrávání. Rozhraní API pro nahrávání hovorů používají k zahájení nahrávání výhradně serverCallId rozhraní API. Informace o tom, jak získat, najdete v rychlém startuserverCallId nahrávání hovorů. Vrátí recordingId se při spuštění záznamu, který se pak použije pro následné operace, jako je pozastavení a obnovení.

Operace Funguje na Komentáře
Spustit záznam serverCallId Vrátí recordingId
Získání stavu záznamu recordingId Vrátí RecordingStateResult
Pozastavit záznam recordingId Pozastavení a obnovení záznamu hovoru umožňuje přeskočit nahrávání části hovoru nebo schůzky a pokračovat v nahrávání do jednoho souboru.
Pokračovat v nahrávání recordingId Obnoví operaci pozastaveného záznamu. Obsah je součástí stejného souboru jako obsah před pozastavením.
Zastavit nahrávání recordingId Zastaví nahrávání a zahájí konečné zpracování médií pro stažení souboru.

Oznámení Event Gridu

Záznam volání používá Azure Event Grid k poskytování oznámení souvisejících s multimédii a metadaty.

Poznámka:

Azure Communication Services poskytuje krátkodobé úložiště médií pro nahrávky. Nahrávky budou k dispozici ke stažení po dobu 48 hodin. Po 48 hodinách už nebudou nahrávky dostupné.

Oznámení Microsoft.Communication.RecordingFileStatusUpdated Event Gridu se publikuje, když je záznam připravený k načtení, obvykle několik minut po dokončení procesu nahrávání (například schůzka skončila, nahrávání se zastavilo). Mezi oznámení událostí záznamu patří contentLocation a metadataLocationkteré se používají k načtení nahraného média i souboru metadat záznamu.

Referenční informace ke schématu oznámení

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

Referenční dokumentace schématu metadat

{
  "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
    }
  ]
}

Zásady dodržování právních předpisů a ochrany osobních údajů

Mnoho zemí/oblastí a států má zákony a předpisy, které se vztahují na záznam hovorů. Volání do veřejné telefonní sítě, hlasové hovory a videohovory často vyžadují, aby uživatelé vyjádřili souhlas se záznamem komunikace. Je vaší odpovědností používat funkce nahrávání hovorů v souladu se zákonem. Musíte získat souhlas stran zaznamenané komunikace způsobem, který je v souladu s právními předpisy platnými pro každého účastníka.

Předpisy týkající se údržby osobních údajů vyžadují možnost exportovat uživatelská data. Aby bylo možné tyto požadavky podporovat, soubory metadat záznamu obsahují ID účastníka pro každého účastníka hovoru v participants poli. Identitu uživatele azure Communication Services můžete křížově odkazovat v participants poli s interními identitami uživatelů a identifikovat účastníky volání.

Další kroky

Začínáme se záznamem hovoru

Tady je několik článků, které vás zajímají: