Skip to content

Commit 6b6510c

Browse files
committed
Title updated as well as a few typos.
1 parent ce92e7c commit 6b6510c

File tree

1 file changed

+36
-3
lines changed

1 file changed

+36
-3
lines changed

articles/communication-services/concepts/voice-video-calling/call-recording.md

Lines changed: 36 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.custom: references_regions
1313
ms.service: azure-communication-services
1414
ms.subservice: calling
1515
---
16-
# Calling Recording overview
16+
# Call Recording overview
1717

1818
[!INCLUDE [Public Preview](../../includes/public-preview-include-document.md)]
1919

@@ -25,7 +25,7 @@ Call Recording provides a set of APIs to start, stop, pause and resume recording
2525
![Call recording concept diagram](../media/call-recording-concept.png)
2626

2727
## Media output types
28-
Call recording currently supports mixed audio+video MP4 and mixed audio-only MP3/WAV output formats in Public Preview. The mixed audio+video output media matches meeting recordings produced via Microsoft Teams recording.
28+
Call recording currently supports mixed audio+video MP4 and mixed audio MP3/WAV output formats in Public Preview. The mixed audio+video output media matches meeting recordings produced via Microsoft Teams recording.
2929

3030
| Content Type | Content Format | Channel Type | Video | Audio |
3131
| :----------- | :------------- | :----------- | :---- | :--------------------------- |
@@ -90,13 +90,46 @@ An Event Grid notification `Microsoft.Communication.RecordingFileStatusUpdated`
9090
"eventTime": string // ISO 8601 date time for when the event was created
9191
}
9292
```
93+
## Metadata Schema
94+
```typescript
95+
{
96+
"resourceId": <string>, // stable resource id of the ACS resource recording
97+
"callId": <string>, // group id of the call
98+
"chunkDocumentId": <string>, // object identifier for the chunk this metadata corresponds to
99+
"chunkIndex": <number>, // index of this chunk with respect to all chunks in the recording
100+
"chunkStartTime": <string>, // ISO 8601 datetime for the start time of the chunk this metadata corresponds to
101+
"chunkDuration": <number>, // duration of the chunk this metadata corresponds to in milliseconds
102+
"pauseResumeIntervals": [
103+
"startTime": <string>, // ISO 8601 datetime for the time at which the recording was paused
104+
"duration": <number> // duration of the pause in the recording in milliseconds
105+
],
106+
"recordingInfo": {
107+
"contentType": <string>, // content type of recording, e.g. audio/audioVideo
108+
"channelType": <string>, // channel type of recording, e.g. mixed/unmixed
109+
"format": <string>, // format of the recording, e.g. mp4/mp3/wav
110+
"audioConfiguration": {
111+
"sampleRate": <number>, // sample rate for audio recording
112+
"bitRate": <number>, // bitrate for audio recording
113+
"channels": <number> // number of audio channels in output recording
114+
}
115+
},
116+
"participants": [
117+
{
118+
"participantId": <string>, // participant identifier of a participant captured in the recording
119+
"channel": <number> // channel the participant was assigned to if the recording is unmixed
120+
}
121+
]
122+
}
123+
124+
```
125+
93126
## Regulatory and privacy concerns
94127

95128
Many countries and states have laws and regulations that apply to the recording of PSTN, voice, and video calls, which often require that users consent to the recording of their communications. It is your responsibility to use the call recording capabilities in compliance with the law. You must obtain consent from the parties of recorded communications in a manner that complies with the laws applicable to each participant.
96129

97130
Regulations around the maintenance of personal data require the ability to export user data. In order to support these requirements, recording metadata files include the participantId for each call participant in the `participants` array. You can cross-reference the MRIs in the `participants` array with your internal user identities to identify participants in a call. An example of a recording metadata file is provided below for reference.
98131

99-
## Availability
132+
## Language availability
100133
Currently, Azure Communication Services Call Recording APIs are available in C# and Java.
101134

102135
## Next steps

0 commit comments

Comments
 (0)