Delen via


Overzicht van gespreksopname

Met gespreksopname kunt u meerdere oproepscenario's opnemen die beschikbaar zijn in Azure Communication Services door u een set API's te bieden voor het starten, stoppen, onderbreken en hervatten van de opname. Of het nu gaat om een PSTN-, WebRTC- of SIP-aanroep, deze API's kunnen worden geopend vanuit uw bedrijfslogica aan de serverzijde. Opnamen kunnen ook worden geactiveerd door een gebruikersactie die aangeeft dat de servertoepassing de opname moet starten.

Afhankelijk van de behoeften van uw bedrijf kunt u Gespreksopname gebruiken voor verschillende azure Communication Services-aanroepende implementaties.

U kunt bijvoorbeeld 1:1 of 1:N audio- en videogesprekken opnemen:

Diagram met een aanroep die wordt vastgelegd.

U kunt gespreksopname ook gebruiken om complexe PSTN- of VoIP-werkstromen voor inkomend en uitgaand bellen op te nemen die worden beheerd door Gespreksautomatisering.

Ongeacht hoe u het gesprek tot stand hebt gebracht, kunt u met gespreksopname gemengde of niet-gemengde mediabestanden produceren die gedurende 24 uur worden opgeslagen op een ingebouwde tijdelijke opslag. U kunt de bestanden ophalen, verplaatsen in uw eigen Azure Blob Store Bring Your Own Storage of een opslagoplossing van uw keuze. Oproepopname ondersteunt alle Azure Communication Services-gegevensregio's.

Diagram met de architectuur voor het opnemen van gesprekken.

Oproepopname die ondersteuning biedt voor uw bedrijfsbehoeften

Gespreksopname ondersteunt meerdere media-uitvoer en inhoudstypen om te voldoen aan de behoeften en gebruiksvoorbeelden van uw bedrijf. U kunt gemengde indelingen gebruiken voor scenario's zoals het bewaren van records, notulen, coaching en training, of zelfs naleving en naleving. U kunt ook een ongemixte audio-indeling gebruiken om gebruiksvoorbeelden voor kwaliteitscontrole aan te pakken of nog complexere scenario's zoals geavanceerde analyses of kunstmatige intelligentie (kunstmatige intelligentie) geavanceerde post-callprocessen.

Video’s

Kanaaltype Inhoudsopmaak Oplossing Samplefrequentie Bitrate Gegevenssnelheid Uitvoer Beschrijving
gemengd mp4 1920x1080, 16 FPS (frames per seconde) 16 kHz 1 Mbps 7,5 MB/min* enkel bestand, één kanaal gemengde video in een standaardtegelindeling van 3x3 (meest actieve sprekers) met ondersteuning voor weergavenamen

Audio

Kanaaltype Inhoudsopmaak Samplefrequentie Bitrate Gegevenssnelheid Uitvoer Beschrijving
gemengd Mp3 16 kHz 48 kbps 0,36 MB/min* enkel bestand, één kanaal gemengde audio van alle deelnemers
gemengd Wav 16 kHz 256 kbps 1,92 MB/min. enkel bestand, één kanaal gemengde audio van alle deelnemers
Unmixed Wav 16 kHz 256 kbps 1,92 MB/min* per kanaal enkel bestand, maximaal 5 wav-kanalen ongemixte audio, één deelnemer per kanaal, maximaal vijf kanalen

[*OPMERKING] Mp3- en Mp4-indelingen maken gebruik van lossy-compressie die resulteert in variabele bitrate; Daarom weerspiegelen gegevenssnelheidswaarden in de voorgaande tabellen het theoretische maximum. WAV-indeling is niet gecomprimeerd en bitrate is vast, zodat de berekeningen van de gegevenssnelheid exact zijn.

Krijg volledige controle over uw opnamen met onze Call Recording-API's

U kunt call recording-API's gebruiken om opname te beheren via interne bedrijfslogicatriggers, zoals een toepassing die een groepsgesprek maakt en het gesprek opneemt. Opnamen kunnen ook worden geactiveerd door een gebruikersactie die aangeeft dat de servertoepassing de opname moet starten. Call Recording-API's maken uitsluitend gebruik van de serverCallId opname om opname te initiëren. Raadpleeg onze quickstart voor het opnemen van gesprekken voor meer informatie over hoe u de serverCallIdopdracht krijgt. Er wordt een recordingId geretourneerd wanneer de opname wordt gestart, die vervolgens kan worden gebruikt voor vervolgbewerkingen zoals onderbreken en hervatten.

Operation Werkt op Opmerkingen
Opname starten serverCallId Retourneert recordingId
Opnamestatus ophalen recordingId Retourneert RecordingStateResult
Opname onderbreken recordingId Als u de opname van gesprekken onderbroken en hervat, kunt u het opnemen van een deel van een gesprek of vergadering overslaan en de opname hervatten naar één bestand.
Opname hervatten recordingId Hiermee wordt een onderbroken opnamebewerking hervat. Inhoud wordt opgenomen in hetzelfde bestand als inhoud van vóór het onderbreken.
Opname stoppen recordingId Stopt met opnemen en start de uiteindelijke mediaverwerking voor het downloaden van bestanden.

Event Grid-meldingen

Gespreksopname gebruikt Azure Event Grid om u meldingen te geven met betrekking tot media en metagegevens.

Notitie

Azure Communication Services biedt kortetermijnmediaopslag voor opnamen. Opnamen zijn 24 uur beschikbaar om te downloaden. Na 24 uur zijn opnamen niet meer beschikbaar.

Een Event Grid-melding Microsoft.Communication.RecordingFileStatusUpdated wordt gepubliceerd wanneer een opname gereed is voor ophalen, meestal een paar minuten nadat het opnameproces is voltooid, zoals de vergadering is beëindigd of de opname is gestopt. Opname van gebeurtenismeldingen zijn onder andere contentLocation en metadataLocation, die worden gebruikt om zowel opgenomen media als een bestand met opnamemetagegevens op te halen.

Naslaginformatie over meldingsschema's

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

Naslaginformatie over metagegevensschema's

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

Problemen met regelgeving en privacy

Veel landen/regio's en staten hebben wetten en voorschriften die van toepassing zijn op het opnemen van gesprekken. PstN-, spraak- en videogesprekken vereisen vaak dat gebruikers toestemming geven voor de opname van hun communicatie. Het is uw verantwoordelijkheid om de gespreksopnamemogelijkheden te gebruiken in overeenstemming met de wet. U dient toestemming te verkrijgen van de partijen die deelnemen aan de opgenomen communicatie op een wijze die voldoet aan de wetten die van toepassing zijn op elke respectieve deelnemer.

Regelgeving rond het onderhoud van persoonsgegevens vereist de mogelijkheid om gebruikersgegevens te exporteren. Om deze vereisten te ondersteunen, bevatten de opname van metagegevensbestanden de participantId voor elke oproepdeelnemer in de participants matrix. U kunt in de matrix kruislings verwijzen naar de participants Azure Communication Services-gebruikersidentiteit met uw interne gebruikersidentiteiten om deelnemers aan een gesprek te identificeren.

Volgende stappen

Hier volgen enkele artikelen die voor u interessant zijn: