Panoramica della registrazione delle chiamate
Registrazione chiamate consente di registrare più scenari di chiamata disponibili in Servizi di comunicazione di Azure fornendo un set di API per avviare, arrestare, sospendere e riprendere la registrazione. Che si tratti di una chiamata PSTN, WebRTC o SIP, è possibile accedere a queste API dalla logica di business lato server. Inoltre, le registrazioni possono essere attivate da un'azione dell'utente che indica all'applicazione server di avviare la registrazione.
A seconda delle esigenze aziendali, è possibile usare Registrazione chiamate per diverse implementazioni di chiamata Servizi di comunicazione di Azure.
Ad esempio, è possibile registrare chiamate audio e video 1:1 o 1:N:
È anche possibile usare La registrazione delle chiamate per registrare flussi di lavoro pstN complessi o voIP in ingresso e in uscita gestiti da Automazione chiamate.
Indipendentemente dal modo in cui è stata stabilita la chiamata, Call Recording consente di produrre file multimediali misti o non misti archiviati per 24 ore in una risorsa di archiviazione temporanea predefinita. È possibile recuperare i file, spostarli nel proprio archivio BLOB di Azure Bring Your Own Archiviazione o in una soluzione di archiviazione preferita. Registrazione chiamate supporta tutte le aree dati Servizi di comunicazione di Azure.
Registrazione delle chiamate che supporta le esigenze aziendali
La registrazione delle chiamate supporta più output multimediali e tipi di contenuto per soddisfare le esigenze aziendali e i casi d'uso. È possibile usare formati misti per scenari quali la conservazione dei record, le note sulle riunioni, il coaching e la formazione o persino la conformità e la conformità. In alternativa, è possibile usare un formato audio non mescolato per risolvere i casi d'uso di controllo della qualità o scenari ancora più complessi, ad esempio analisi avanzata o intelligenza artificiale (intelligenza artificiale) sofisticati processi post-chiamata.
Video
| Tipo di canale | Formato contenuto | Risoluzione | Frequenza di campionamento | Velocità in bit | Velocità dati | Output | Descrizione |
|---|---|---|---|---|---|---|---|
| mixed | mp4 | 1920x1080, 16 FPS (fotogrammi al secondo) | 16 kHz | 1 Mbps | 7,5 MB/min* | singolo file, canale singolo | video misto in una disposizione predefinita 3x3 (altoparlanti più attivi) con supporto del nome visualizzato |
Audio
| Tipo di canale | Formato contenuto | Frequenza di campionamento | Velocità in bit | Velocità dati | Output | Descrizione |
|---|---|---|---|---|---|---|
| mixed | mp3 | 16 kHz | 48 kbps | 0,36 MB/min* | singolo file, canale singolo | audio misto di tutti i partecipanti |
| mixed | wav | 16 kHz | 256 Kbps | 1,92 MB/min | singolo file, canale singolo | audio misto di tutti i partecipanti |
| non mescolato | wav | 16 kHz | 256 Kbps | 1,92 MB/min* per canale | file singolo, fino a 5 canali wav | audio non mescolato, un partecipante per canale, fino a cinque canali |
[*NOTA] I formati Mp3 e Mp4 usano la compressione con perdita di dati che comporta una velocità in bit variabile; pertanto, i valori della frequenza dei dati nelle tabelle precedenti riflettono il valore massimo teorico. Il formato WAV non è compresso e la velocità in bit è fissa, quindi i calcoli della velocità dei dati sono esatti.
Ottenere il controllo completo sulle registrazioni con le API di registrazione delle chiamate
È possibile usare le API di registrazione delle chiamate per gestire la registrazione tramite trigger di logica di business interni, ad esempio un'applicazione che crea una chiamata di gruppo e registra la conversazione. Inoltre, le registrazioni possono essere attivate da un'azione dell'utente che indica all'applicazione server di avviare la registrazione. Le API di registrazione delle chiamate usano esclusivamente l'oggetto per avviare la serverCallId registrazione. Per informazioni su come ottenere serverCallId, vedere la guida introduttiva alla registrazione delle chiamate.
Un recordingId viene restituito all'avvio della registrazione, che può quindi essere usato per operazioni di follow-on come pausa e ripresa.
| Operazione | Opera su | Commenti |
|---|---|---|
| Avvia registrazione | serverCallId |
Restituisce recordingId. |
| Ottenere lo stato di registrazione | recordingId |
Restituisce RecordingStateResult. |
| Sospendi registrazione | recordingId |
La sospensione e la ripresa della registrazione delle chiamate consente di ignorare la registrazione di una parte di una chiamata o di una riunione e riprendere la registrazione in un singolo file. |
| Riprendi registrazione | recordingId |
Riprende un'operazione di registrazione sospesa. Il contenuto viene incluso nello stesso file del contenuto di prima della sospensione. |
| Interrompi registrazione | recordingId |
Arresta la registrazione e avvia l'elaborazione multimediale finale per il download di file. |
Notifiche di Griglia di eventi
La registrazione delle chiamate usa Griglia di eventi di Azure per fornire notifiche relative ai file multimediali e ai metadati.
Nota
Servizi di comunicazione di Azure fornisce spazio di archiviazione multimediale a breve termine per le registrazioni. Le registrazioni sono disponibili per il download per 24 ore. Dopo 24 ore, le registrazioni non sono più disponibili.
Una notifica Microsoft.Communication.RecordingFileStatusUpdated di Griglia di eventi viene pubblicata quando una registrazione è pronta per il recupero, in genere alcuni minuti dopo il completamento del processo di registrazione, ad esempio la fine della riunione o la registrazione è stata arrestata. Le notifiche degli eventi di registrazione includono contentLocation e metadataLocation, che vengono usate per recuperare sia i supporti registrati che un file di metadati di registrazione.
Informazioni di riferimento sullo schema di notifica
{
"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
}
Informazioni di riferimento sullo schema dei metadati
{
"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
}
]
}
Problemi normativi e sulla privacy
Molti paesi/aree geografiche e stati hanno leggi e normative applicabili alla registrazione delle chiamate. Le chiamate PSTN, vocali e video richiedono spesso il consenso degli utenti alla registrazione delle comunicazioni. È tua responsabilità utilizzare le funzionalità di registrazione delle chiamate in conformità con la legge. La Società dovrà ottenere il consenso delle parti delle comunicazioni registrate conformemente alle leggi applicabili a ciascun partecipante.
Le normative relative alla manutenzione dei dati personali richiedono la possibilità di esportare i dati utente. Per supportare questi requisiti, i file di metadati di registrazione includono per participantId ogni partecipante alla chiamata nella participants matrice. È possibile fare riferimento incrociato all'identità utente Servizi di comunicazione di Azure nella participants matrice con le identità utente interne per identificare i partecipanti in una chiamata.
Passaggi successivi
Introduzione alla registrazione delle chiamate.
Ecco alcuni articoli di interesse per te:
- Altre informazioni sulla registrazione delle chiamate di Dati analitici e log
- Altre informazioni su Automazione delle chiamate.
- Altre informazioni sulle videochiamate.