Hívásrögzítés áttekintése

Cikk
05/07/2024

A hívásrögzítés lehetővé teszi több, az Azure Communication Servicesben elérhető hívási forgatókönyv rögzítését azáltal, hogy a rögzítés elindításához, leállításához, szüneteltetéséhez és folytatásához api-kat biztosít. Akár PSTN-, WebRTC-, akár SIP-hívásról van szó, ezek az API-k a kiszolgálóoldali üzleti logikából érhetők el. A felvételeket egy olyan felhasználói művelet is aktiválhatja, amely arra utasítja a kiszolgálóalkalmazást, hogy indítsa el a felvételt.

Az üzleti igényektől függően a hívásrögzítést használhatja különböző Azure Communication Services-hívási implementációkhoz.

Rögzíthet például 1:1 vagy 1:N hang- és videohívásokat:

A rögzített hívásokat ábrázoló diagram.

Hívásrögzítéssel összetett PSTN- vagy VoIP-bejövő és kimenő hívási munkafolyamatokat is rögzíthet, amelyeket a Call Automation kezel.

Függetlenül attól, hogy hogyan hozta létre a hívást, a Hívásrögzítés lehetővé teszi, hogy egy beépített ideiglenes tárolóban 24 órán keresztül tárolt vegyes vagy nem kevert médiafájlokat készítsen. Lekérheti a fájlokat, áthelyezheti őket a saját Azure Blob Store-ba , vagy egy tetszőleges tárolási megoldásba. A hívásrögzítés minden Azure Communication Services-adatrégió esetében támogatott.

A hívásrögzítési architektúrát bemutató ábra.

Az üzleti igényeket támogató hívásrögzítés

A Hívásrögzítés több médiakimenetet és tartalomtípust támogat az üzleti igények és a használati esetek kielégítése érdekében. Használhat vegyes formátumokat olyan forgatókönyvekhez, mint a rekordok, értekezleti jegyzetek, coaching és betanítás, vagy akár a megfelelőség és a megfelelőség. Vagy használhat nem kevert hangformátumot a minőségbiztosítási használati esetek vagy még összetettebb forgatókönyvek, például a fejlett elemzések vagy az AI-alapú (mesterséges intelligencia) kifinomult hívás utáni folyamatok kezelésére.

Videó

Csatorna típusa	Tartalomformátum	Resolution (Osztás)	Mintavételezési frekvencia	Bitsűrűség	Adatsebesség	Hozam	Leírás
vegyes	mp4	1920x1080, 16 FPS (képkockák másodpercenként)	16 kHz	1 mb/s	7,5 MB/perc*	egyfájlos, egycsatornás	vegyes videó alapértelmezett 3x3 -os (legaktívabb hangszórók) csempeelrendezésben a megjelenítési név támogatásával

Hang

Csatorna típusa	Tartalomformátum	Mintavételezési frekvencia	Bitsűrűség	Adatsebesség	Hozam	Leírás
vegyes	Mp3	16 kHz	48 kb/s	0,36 MB/perc*	egyfájlos, egycsatornás	az összes résztvevő vegyes hanganyaga
vegyes	Wav	16 kHz	256 kbit/s	1,92 MB/perc	egyfájlos, egycsatornás	az összes résztvevő vegyes hanganyaga
Kevert	Wav	16 kHz	256 kbit/s	Csatornánként 1,92 MB/perc*	egyetlen fájl, legfeljebb 5 hullámos csatorna	nem kevert hang, csatornánként egy résztvevő, legfeljebb öt csatorna

[*MEGJEGYZÉS] Az MP3- és MP4-formátumok veszteséges tömörítést használnak, amely változó bitrátát eredményez; ezért az előző táblák adatsebesség-értékei az elméleti maximumot tükrözik. A WAV formátum tömörítetlen, a bitráta pedig rögzített, így az adatsebesség-számítások pontosak.

A hívásrögzítési API-kkal teljes mértékben szabályozhatja a felvételeket

A Hívásrögzítés API-k segítségével belső üzleti logikai eseményindítókon keresztül kezelheti a rögzítést, például egy alkalmazás csoportos hívást hoz létre és rögzíti a beszélgetést. A felvételeket egy olyan felhasználói művelet is aktiválhatja, amely arra utasítja a kiszolgálóalkalmazást, hogy indítsa el a felvételt. A hívásrögzítési API-k kizárólag a serverCallId rögzítés kezdeményezésére használhatók. Ha meg szeretné tudni, hogyan szerezheti be a elemet, tekintse meg a serverCallIdHívásfelvétel rövid útmutatót. A recordingId rendszer a rögzítés indításakor ad vissza egy hibát, amely aztán a folytatási műveletekhez, például a szüneteltetéshez és a folytatáshoz használható.

Művelet	Működés:	Megjegyzések
Felvétel indítása	`serverCallId`	Visszatér `recordingId`
Rögzítési állapot lekérése	`recordingId`	Visszatér `RecordingStateResult`
Rögzítés felfüggesztése	`recordingId`	A hívásfelvétel szüneteltetésével és folytatásával kihagyhatja a hívás vagy értekezlet egy részének rögzítését, és folytathatja a felvételt egyetlen fájlba.
Felvétel folytatása	`recordingId`	Szüneteltetett rögzítési műveletet folytat. A tartalom ugyanabban a fájlban található, mint a szüneteltetés előtti tartalom.
Rögzítés leállítása	`recordingId`	Leállítja a felvételt, és kezdeményezi a végleges médiafeldolgozást a fájlletöltéshez.

Event Grid-értesítések

A hívásrögzítés az Azure Event Grid használatával biztosítja a média- és metaadatokkal kapcsolatos értesítéseket.

Feljegyzés

Az Azure Communication Services rövid távú médiatárolást biztosít a felvételekhez. A felvételek 24 órán át tölthetők le. 24 óra elteltével a felvételek már nem érhetők el.

Eseményrács-értesítés Microsoft.Communication.RecordingFileStatusUpdated akkor jelenik meg, ha egy felvétel készen áll a lekérésre, általában néhány perccel a rögzítési folyamat befejeződése után, például az értekezlet befejeződése vagy a rögzítés leállítása után. A rögzítési eseményértesítések közé tartoznak contentLocation a rögzített adathordozók és metadataLocationa rögzített metaadatfájlok lekérésére szolgáló értesítések is.

Értesítési séma referenciája

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

Metaadatok sémareferenciája

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

Szabályozási és adatvédelmi problémák

Számos ország/régió és állam rendelkezik a hívásrögzítésre vonatkozó jogszabályokkal és szabályozásokkal. A PSTN-, hang- és videohívásokhoz gyakran szükséges, hogy a felhasználók hozzájáruljanak a kommunikációjuk rögzítéséhez. Ön a felelős azért, hogy a hívásfelvevő képességeket a jogszabályoknak megfelelően használja. A felvett kommunikációban érintett felektől olyan módon kell beszereznie a hozzájárulásukat, amely teljesíti az egyes résztvevőkre alkalmazandó jogszabályok előírásait.

A személyes adatok karbantartására vonatkozó szabályozás megköveteli a felhasználói adatok exportálását. Ezeknek a követelményeknek a támogatása érdekében a metaadatfájlok rögzítése magában foglalja a participantId tömb minden egyes hívási résztvevőjének participants adatait. A hívás résztvevőinek azonosításához kereszthivatkozást végezhet a tömbben található participants Azure Communication Services felhasználói identitásra a belső felhasználói identitásokkal.

Következő lépések

Ismerkedés a hívásrögzítéssel.

Íme néhány érdekes cikk az Ön számára:

További információ a hívásrögzítési Elemzések és naplókról
További információ a Hívásautomatizálásról.
További információ a videohívásról.

Megosztás a következőn keresztül: