共用方式為

Azure 通訊服務通話錄音記錄

  • 發行項

Azure 通訊服務會提供記錄功能，以供您監視通訊服務解決方案並對其進行偵錯。 您可以透過 Azure 入口網站設定這些功能。

本文中的內容是指透過 Azure 監視器 (部分機器翻譯) 啟用的記錄 (另請參閱常見問題集 (部分機器翻譯))。 若要為通訊服務啟用這些記錄，請參閱在診斷設定中啟用記錄。

資源記錄類別

通訊服務提供下列類型的記錄供您啟用：

  • 使用量記錄：提供與每個計費服務供應項目相關聯的使用量資料。
  • 通話錄音摘要記錄：提供通話錄音的摘要資訊，例如：
    • 通話持續時間。
    • 媒體內容 (例如音訊/視訊、原音或轉譯)。
    • 用於錄音的格式類型 (例如 WAV 或 MP4)。
    • 錄音結束的原因。
  • 錄音傳入作業記錄：提供通話錄音作業傳入要求的相關資訊。 每個項目都會對應至通話錄音 API 通話的結果，例如 StartRecording、StopRecording、PauseRecording 和 ResumeRecording。

錄音檔案會在通話或會議結束時產生。 使用者或應用程式 (Bot) 都可以啟動和停止錄音。 錄音也可能因為系統失敗而結束。

摘要記錄會在錄音準備好下載之後發佈。 記錄會在 Azure 監視器資源記錄的標準延遲時間內發佈。 請參閱 Azure 監視器中的記錄資料擷取時間。

使用量記錄結構描述

屬性 說明
timestamp 產生記錄時的時間戳記 (UTC)。
operationName 與記錄錄製相關聯的作業。
operationVersion 與作業相關聯的 api-version 值 (如果透過 API 執行 operationName 的話)。 如果沒有對應至此作業的 API，則版本代表該作業的版本，以防與作業相關聯的屬性日後變更。
category 事件的記錄類別。 類別是您可在資源上啟用或停用記錄的細微性。 出現在事件的 properties Blob 內的屬性，與在記錄類別和資源類型內的相同。
correlationID 相互關聯事件的識別碼。 您可以使用此識別碼來識別多個資料表之間相互關聯的事件。
Properties 適用於各種通訊服務模式的其他資料。
recordID 使用記錄的唯一識別碼。
usageType 使用模式 (例如，聊天、PSTN 或 NAT)。
unitType 使用方式的單位類型是以使用模式為基礎 (例如，分鐘數、MB 或訊息數)。
quantity 此記錄所使用或取用的單位數。

通話錄音摘要記錄結構描述

屬性名稱 資料類型 描述
timeGenerated Datetime 產生記錄時的時間戳記 (UTC)。
operationName String 與記錄錄製相關聯的作業。
correlationId String 用來將資料表之間的事件相互關聯的識別碼。
recordingID String 此記錄所參照錄製的識別碼。
category String 事件的記錄類別。 具有相同記錄類別和資源類型的記錄，會有相同的屬性欄位。
resultType String 作業的狀態。
level String 作業的嚴重性層級。
chunkCount 整數 為錄製建立的區塊總數。
channelType String 錄製的頻道類型，例如混合或原音。
recordingStartTime Datetime 錄製開始的時間。
contentType String 錄製的內容，例如僅限音訊、音訊/視訊或轉譯。
formatType String 錄製的檔案格式。
recordingLength Double 錄製的持續時間 (秒)。
audioChannelsCount 整數 錄製中的音訊頻道總數。
recordingEndReason String 錄音結束的原因。

通話錄音和範例資料

"operationName":            "Call Recording Summary",
"operationVersion":         "1.0",
"category":                 "RecordingSummary",

通話可以有一份錄音或多份錄音，視觸發錄音事件的次數而定。

例如，如果服務專員在錄音的線路中起始了外撥通話，而通話因網路訊號不佳而中斷，則 callID 會有一個 recordingID 值。 如果服務專員回電給客戶，系統會產生新的 callID 執行個體和新的 recordingID 值。

範例：一次通話一份錄音的通話錄音

"properties"
{  
  "TimeGenerated":"2022-08-17T23:18:26.4332392Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "zzzzzz-cada-4164-be10-0000000000",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuZHBvaW5xxxxxxxxFmNjkwxxxxxxxxxxxxSZXNvdXJjZVNwZWNpZmljSWQiOiJiZGU5YzE3Ni05M2Q3LTRkMWYtYmYwNS0yMTMwZTRiNWNlOTgifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-16T09:07:54.0000000Z",
    "RecordingLength": "73872.94",
    "ChunkCount": 6,
   "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}

如果服務專員啟動錄音，然後在通話仍在進行時多次停止並重新啟動錄音，則 callID 會有許多 recordingID 值。 值數目取決於觸發錄音事件的次數。

範例：一次通話多份錄音的通話錄音


{   
 "TimeGenerated": "2022-08-17T23:55:46.6304762Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuZHBxxxxxxxxxxxxjkwMC05MmEwLTRlZDYtOTcxYS1kYzZlZTkzNjU0NzciLCJSxxxxxNwZWNpZmljSWQiOiI5ZmY2ZTY2Ny04YmQyLTQ0NzAtYmRkYy00ZTVhMmUwYmNmOTYifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-17T23:55:43.3304762Z",
    "RecordingLength": 3.34,
    "ChunkCount": 1,
    "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}
{
    "TimeGenerated": "2022-08-17T23:55:56.7664976Z",
    "OperationName": "RecordingSummary",
    "Category": "CallRecordingSummary",
    "CorrelationId": "xxxxxxx-cf78-4156-zzzz-0000000fa29cc",
    "ResultType": "Succeeded",
    "Level": "Informational",
    "RecordingId": "eyJQbGF0Zm9ybUVuxxxxxxiOiI4NDFmNjkwMC1mMjBiLTQzNmQtYTg0Mi1hODY2YzE4M2Y0YTEiLCJSZXNvdXJjZVNwZWNpZmljSWQiOiI2YzRlZDI4NC0wOGQ1LTQxNjEtOTExMy1jYWIxNTc3YjM1ODYifQ",
    "RecordingEndReason": "CallEnded",
    "RecordingStartTime": "2022-08-17T23:55:54.0664976Z",
    "RecordingLength": 2.7,
    "ChunkCount": 1,
    "ContentType": "Audio - Video",
    "ChannelType": "mixed",
    "FormatType": "mp4",
    "AudioChannelsCount": 1
}

ACSCallRecordingIncomingOperations 記錄

屬性如下：

屬性 說明
timeGenerated 產生記錄時的時間戳記 (UTC)。
callConnectionId 通話連線或連結的識別碼 (如果有的話)。
callerIpAddress 呼叫端 IP 位址，如果作業對應至來自具有公開可用 IP 位址之實體的 API 呼叫。
correlationId 相互關聯事件的識別碼。 您可以使用此識別碼來識別多個資料表之間相互關聯的事件。
durationMs 作業的持續時間 (以毫秒為單位)。
level 作業的嚴重性層級。
operationName 與記錄錄製相關聯的作業。
operationVersion 與作業或作業版本相關聯的 API 版本 (如果沒有 API 版本)。
resourceId 記錄相關資源的唯一識別碼。
resultSignature 作業的子狀態。 如果此作業對應至 REST API 呼叫，則此欄位是對應 REST 呼叫的 HTTP 狀態碼。
resultType 作業的狀態。
sdkType 在要求中使用的 SDK 類型。
sdkVersion SDK 版本。
serverCallId 伺服器通話識別碼。
URI 要求的 URI。

以下是範例：

"properties"
{  "TimeGenerated": "2023-05-09T15:58:30.100Z",
    "Level": "Informational",
    "CorrelationId": "a999f996-b4e1-xxxx-ac04-a59test87d97",
    "OperationName": "ResumeCallRecording",
    "OperationVersion": "2023-03-06",
    "URI": "https://acsresouce.communication.azure.com/calling/recordings/   eyJQbGF0Zm9ybUVuZHBviI0MjFmMTIwMC04MjhiLTRmZGItOTZjYi0...:resume?api-version=2023-03-06",
    "ResultType": "Succeeded",
    "ResultSignature": 202,
    "DurationMs": 130,
    "CallerIpAddress": "127.0.0.1",
    "CallConnectionId": "d5596715-ab0b-test-8eee-575c250e4234",
    "ServerCallId": "aHR0cHM6Ly9hcGk0vjCCCCCCQd2pRP2k9OTMmZT02Mzc5OTQ3xMDAzNDUwMzg...",
    "SdkVersion": "1.0.0-alpha.20220829.1",
    "SdkType": "dotnet"
}

下一步