查看通話應用

在通話應用列表頁面，您可以查看通話應用的名稱、bizName、自動錄制狀態、創建時間以及密鑰。

• 通話應用名稱：創建應用時輸入的名稱，可編輯。

• bizName：音視頻通話場景碼，應用創建后自動生成。使用同一個 bizName 的各個終端之間可以進行音視頻通話。

• 自動錄制狀態：自動錄制是否開啟。可點擊 操作 列中的 功能配置 進行配置。

• 創建時間：通話應用的創建時間。

• 密鑰：應用創建后自動生成，用于在服務端生成簽名。點擊 查看文檔 可查看密鑰使用說明。

功能配置

在通話應用列表頁，點擊應用 操作 列中的 功能配置，打開當前應用的功能配置頁面。您可以在此頁面配置云端自動錄制、設置媒體流代理服務器地址。

配置時您需要點擊 編輯 按鈕進入編輯模式；配置完成后，點擊 保存 按鈕，保存您的配置信息。

配置云端自動錄制及錄制回調地址

云端自動錄制指音視頻通話服務端對通話內容自動進行錄制的功能。您可以根據需要啟用或關閉此功能，并設置錄制回調地址。

• 云端自動錄制：開啟該功能時，在音視頻通話發起時服務端會自動對通話內容進行錄制。通話結束時會結束錄制，并生成錄制文件。關閉時，服務端不進行自動錄制。

  說明

  云端錄制的默認狀態為 停用，需手動開啟。

• 設置錄制回調地址：錄制回調地址為使用 HTTP 或 HTTPS 協議的 URL。設置錄制回調地址后，當開始錄制、暫停錄制、結束錄制或錄制文件出現異常時，服務端會將相關狀態信息發送到該 URL。

  服務端使用 POST(application/json) 方式回調，回調請求的字段含義如下所示。

  字段	字段類型	是否必傳	說明
  bizRequestId	String	是	請求 ID。
  bizName	String	是	業務標識。
  appId	String	是	mPaaS 應用的 ID。
  workspaceId	String	是	工作空間 ID。
  roomId	String	是	房間號 ID。
  recordId	String	是	錄制 ID。
  eventCode	Int	是	0：錄制某條流成功。 10：初始化成功。 11：錄制結束。 50：錄制警告。 99：錄制結果。 500301：流斷開警告。 500302：低幀率警告。 1000xx：錄制啟動階段失敗。 100001：連接 room 失敗。 100002：加入房間失敗。 100003：訂閱流失敗。 100004：訂閱路數缺失。 100005：連接 mcu 失敗。 100006：視頻長寬比異常。 100007：實際自定義混流流數大于設置數目。 1001xx：錄制過程中失敗。 100101：錄制文件創建失敗。 100102：錄制文件格式轉換失敗。 100103：文件保存失敗。 100104：音視頻分離失敗。 100105：錄制子進程崩潰。 100106：磁盤滿或者寫文件失敗。 1002xx：錄制結束階段失敗。 100201：上傳文件失敗。
  recordResult	JSON	否	當 eventCode 的值為 99 時必傳。json body 如下： status：int，錄制狀態，必傳。 2：代表錄制成功，持久化文件成功。 3：代表錄制失敗。 fileType：int，文件類型，當 status 的值為 2 時傳輸。 1：local 2：OSS 3：AFTS 4：HDFS filePath：String，文件路徑，當 status 的值為 2 時傳輸。 recordStartTime：long，錄制第一幀的絕對時間（服務器時間，單位為 ms），當 status 的值為 2 時傳輸。 mediaType：int，錄制文件的類型，當 status 的值為 2 時傳輸。 0：音視頻 1：純音頻 2：純視頻

  業務服務器需返回的數據字段如下：

  字段	類型	是否必傳	說明
  bizRequestId	String	是	回調請求中的bizRequestId 。
  code	int	是	狀態碼，成功為 0 。

  數據示例如下。請求數據示例：

  {
  "bizRequestId":"123456789",
  "bizName":"bizName",
  "appId":"appId",
  "workspaceId":"workspaceId",
  "roomId":"xxxxxx",
  "recordId":"record_xxx",
  "eventCode":0,
  "recordResult": {
      "status":2,
      "fileType":2,
      "filePath":"https://xxxxxx",
      "recordStartTime":1592817186122,
      "mediaType":0
  }
  }

  返回數據示例：

  {
  "bizRequestId":"123456789",
  "code":0
  }

配置房間狀態回調地址

房間狀態回調地址為使用 HTTP 或 HTTPS 協議的 URL。設置房間狀態回調地址后，當創建房間、加入房間、離開房間或銷毀房間時，服務端會將相關狀態信息發送到該 URL 地址。

服務端使用 POST(application/json) 方式回調，回調請求的字段含義如下所示。

業務服務器需返回的數據字段如下：

數據示例如下。請求數據示例：

{
"eventCode":3,
"uid":"uid",
"bizName":"bizName",
"appId":"appId",
"bizRequestId":918479352902861,
"time":1669184793529,
"roomId":"roomId",
"workspaceId":"workspaceId"
} 

配置代理服務器地址

若您的網絡中存在安全隔離區，無法直接訪問阿里云服務器，可通過設置代理服務器對媒體流數據進行轉發。設置媒體流代理服務器后，音視頻流數據將通過該代理服務器進行轉發。

配置時需分別填入服務器地址和地址對應的出網 IP，請確保輸入的地址準確。

• 媒體流代理服務器地址格式為：example.aliyundoc.com。

• 若存在多個出網 IP，使用半角分號（;）隔開。