共用方式為


了解呼叫程式碼和子程式碼錯誤

呼叫 SDK 和個別的伺服器基礎結構使用統一架構來表示錯誤。 身為開發人員,使用錯誤程式碼、子程式碼及其對應的結果類別,您可以更輕鬆地了解這些錯誤,並尋找其發生原因的說明,以及如何在未來減少錯誤發生。 錯誤結果的詳細資料可視為:

程式碼會模型化為 3 位數整數,指出用戶端或伺服器回應的回應狀態。 它們會分組成:

  • 成功回應 (200-299)
  • 用戶端錯誤 (400-499)
  • 伺服器錯誤 (500-599)

子程式碼定義為整數,其中每個數字代表一個唯一原因,特定於一組案例或特定案例結果。
訊息用於描述結果,並在結果為失敗時,提供如何減輕問題的提示。
ResultCategory - 表示錯誤的類型。 視內容而定,值可以是 SuccessExpectedErrorUnexpectedClientErrorUnexpectedServerError

重要

本文所述的功能目前處於公開預覽狀態。 此預覽版本沒有服務等級協定,不建議用於處理生產工作負載。 可能不支援特定功能,或可能已經限制功能。 如需詳細資訊,請參閱 Microsoft Azure 預覽版增補使用條款

了解呼叫程式碼和子程式碼的錯誤

錯誤碼、子程式碼和對應的結果類別可協助開發人員識別和診斷錯誤。 通話結束之後,這些錯誤碼會透過 call.callEndReason 屬性來公開。

錯誤碼詳細資料包括:

程式碼 - 代表用戶端或伺服器回應狀態的 3 位數整數。 錯誤碼類別:

  • 成功回應 (200-299)
  • 用戶端錯誤 (400-499)
  • 伺服器錯誤 (500-599)
  • 全域錯誤 (600-699)

子程式代碼 - 定義為整數,其中每個數位代表一個唯一原因,特定案例或特定案例結果群組。

訊息 - 用於描述結果,並在結果失敗時提供如何減輕問題的指示。

ResultCategory - 表示錯誤的類型。 視內容而定,值可以是 SuccessExpectedErrorUnexpectedClientErrorUnexpectedServerError

Azure 通訊服務呼叫 SDK 用戶端錯誤碼和子程式碼

針對用戶端錯誤,如果 resultCategories 屬性為 ExpectedError,則從 SDK 的觀點來看,可能會發生錯誤。 這類錯誤通常發生在先決條件失敗時,例如應用程式傳遞的不正確引數,或當目前的系統狀態不允許 API 呼叫時。 應用程式應該檢查叫用 API 的錯誤原因和邏輯。

子代碼 代碼 訊息 結果類別 建議
40101 408 無法建立 CallAgent。 請再試一次,如果問題持續發生,請收集瀏覽器控制台記錄、.HAR 檔案,並連絡 Azure 通訊服務支援。 UnexpectedClientError
40104 408 無法建立 CallAgent。 請再試一次,如果問題持續發生,請收集瀏覽器控制台記錄、.HAR 檔案,並連絡 Azure 通訊服務支援。 UnexpectedClientError
40114 408 無法連線到 Azure 通訊服務通訊服務。 請再試一次,並檢查瀏覽器的網路要求。 如果請求持續失敗,請收集瀏覽器控制台記錄、.HAR 檔案,並連絡 Azure 通訊服務支援。 UnexpectedClientError 如需詳細資訊,請參閱網路需求
40115 412 無法建立 CallAgent,無法初始化與 Azure 通訊服務基礎結構的連線。 請再試一次,並檢查瀏覽器的網路要求。 如果請求持續失敗,請收集瀏覽器控制台記錄、.HAR 檔案,並連絡 Azure 通訊服務支援。 UnexpectedClientError 如需詳細資訊,請參閱網路需求
40216 500 無法建立 CallAgent。 請再試一次,如果問題持續發生,請收集瀏覽器控制台記錄,並連絡 Azure 通訊服務支援。 UnexpectedClientError
40228 409 無法建立 CallAgent,與此身分識別相關聯的 CallAgent 實例已存在。 處置現有的 CallAgent,或建立具有不同身分識別的新 CallAgent。 ExpectedError
40230 409 無法建立 TeamsCallAgent,與此身分識別相關聯的 TeamsCallAgent 實例已存在。 建立新的 TeamsCallAgent 之前,先處置現有的 TeamsCallAgent。 ExpectedError
40606 405 無法列舉喇叭,不支援在 Android Chrome、iOS Safari 或 macOS Safari 上列舉/選取喇叭。 ExpectedError Android Chrome、iOS Safari 和 macOS Safari 均不支援列舉/選取喇叭。 操作系統會自動選取喇叭 (輸出裝置)。

深入了解裝置管理,以及如何減輕這些問題。
40613 400 無法取得麥克風和/或相機的使用權限,該動作遭到拒絕或失敗。 確保允許瀏覽器和作業系統設定中的存取權限。 ExpectedError 深入了解如何處理裝置存取權限
40614 500 無法要求裝置存取權限。確保已允許瀏覽器設定和作業系統設定中的存取權限,然後再試一次。 如果問題持續發生,請收集瀏覽器控制台記錄,並連絡 Azure 通訊服務支援。 UnexpectedClientError 深入了解如何處理裝置存取權限
41006 400 無法接受來電,目前非響鈴狀態。 訂閱 CallAgent 的 incomingCall 事件,以接受來電。 ExpectedError 請參閱下列文章,以識別問題的根本原因
- 接聽來電
- 訂閱 SDK 事件
41007 400 無法接受來電,目前非響鈴狀態。 訂閱 CallAgent 的 incomingCall 事件,以拒絕來電。 ExpectedError 請參閱下列文章,以識別問題的根本原因
- 接聽來電
- 訂閱 SDK 事件
41015 500 無法將麥克風設為靜音。 請再試一次,如果該問題持續發生,請收集瀏覽器控制台記錄,並連絡 Azure 通訊服務支援。 UnexpectedClientError
41016 400 無法取消麥克風靜音。 請再試一次,如果該問題持續發生,請收集瀏覽器控制台記錄,並連絡 Azure 通訊服務支援。 UnexpectedClientError
41025 400 無法開始視訊,LocalVideoStream 實例無效或空白。 傳遞 LocalVideoStream 實例。 ExpectedError 請確保為開始視訊而傳遞的物件是 LocalVideoStream 的實例。
使用 VideoDeviceInfo 物件或 MediaStream 物件來建構 LocalVideoStream

請參閱下列文章,以識別問題的根本原因:
- 使用視訊相機撥打電話
- 在通話時開始和停止傳送本機視訊
- 存取原始視訊
41027 400 無法開始視訊,已開始影片。 ExpectedError 實用連結:
- 使用視訊相機撥打電話
- 在通話時開始和停止傳送本機視訊
41030 400 無法停止視訊,已停止影片。 ExpectedError 實用連結:
- 使用視訊相機撥打電話
- 在通話時開始和停止傳送本機視訊
41032 400 無法停止視訊,無效的引數。 目前未傳送做為輸入的 LocalVideoStream。 ExpectedError 呼叫中正在傳送的 LocalVideoStream 會儲存在 Call.localVideoStreams[] 陣列中,且類型為 VideoRawMedia
請參閱下列文章,以識別問題的根本原因:
- 使用視訊相機撥打電話
- 在通話時開始和停止傳送本機視訊
- 存取原始視訊
41033 500 無法保留通話。 請再試一次,如果該問題持續發生,請收集瀏覽器控制台記錄,並連絡 Azure 通訊服務支援。 UnexpectedClientError
41034 500 無法繼續通話。 請再試一次,如果該問題持續發生,請收集瀏覽器控制台記錄,並連絡 Azure 通訊服務支援。 UnexpectedClientError
41035 400 無法開始螢幕畫面分享,已開始螢幕畫面分享。 ExpectedError 深入了解在通話時如何開始和停止螢幕畫面分享
41041 400 無法停止螢幕畫面分享,已停止螢幕畫面分享。 ExpectedError 深入了解在通話時如何開始和停止螢幕畫面分享
41048 410 在通話設定流程時無法開始視訊。 確保已允許瀏覽器設定和作業系統設定中的視訊存取權限,並確保攝影機裝置不會使用於另一個流程。 UnexpectedClientError - 系統可能會停用攝影機裝置。
- 由另一個流程所使用的攝影機。
41056 412 無法開始或加入通話,此 Azure 通訊服務資源尚未啟用 Teams 企業語音資源。 請遵循在線教學課程,以啟用 Teams 企業語音資源。 ExpectedError 請參閱如何線上啟用企業語音和電話系統語音信箱使用者,以啟用 Teams 企業語音原則
41071 412 無法開始螢幕畫面分享,通話尚未處於連線狀態。 訂閱通話的 statteChanged 事件,以了解通話連線的時機。 ExpectedError 實用連結:
- 檢查通話屬性
- 訂閱 SDK 事件
41073 412 無法取得或設定自訂 MediaStream,Azure 通訊服務目前已停用此功能。 ExpectedError
43000 412 無法開始視訊,其他流程/應用程式正在使用視訊裝置。 停止在其他流程/應用程式中使用您的攝影機,然後再試一次。 ExpectedError 深入了解如何處理另一個流程正在使用的攝影機
43001 403 無法開始視訊,未授予使用權限以使用選取的視訊裝置。 確保已允許瀏覽器設定和系統設定中視訊裝置的存取權限。 ExpectedError 確保已允許瀏覽器設定和裝置系統設定中攝影機的存取權限。
確保在裝置系統設定中攝影機不會遭到停用。
在 macOS 上,確保系統設定允許螢幕錄製。

實用連結:
- 要求裝置權限-
macOS 上的螢幕共用權限
- 在 macOS 和 iOS 上列舉或存取 Safari 的裝置
43002 500 無法開始視訊,未知錯誤。 然後再試一次。 如果問題持續發生,請連絡 Azure 通訊服務支援人員。 UnexpectedClientError
43004 400 無法切換視訊裝置,無效的輸入。 輸入必須是 VideoDeviceInfo 類型。 ExpectedError 使用設備管理員來取得 VideoDeviceInfo 物件清單,然後使用 VideoDeviceInfo 物件來切換來源。

深入了解如何在通話時開始和停止傳送本機視訊
43005 400 無法切換視訊裝置,無法切換至相同的視訊裝置,已選取該視訊裝置。 ExpectedError
43013 412 無法開始視訊,找不到視訊裝置。 確保視訊裝置已插入系統設定中並啟用。 ExpectedError 請確保攝影機已連線且安裝至您的裝置上。
43014 412 無法開始視訊,要求媒體串流時發生錯誤。 請再試一次,如果問題持續發生,請連絡 Azure 通訊服務支持人員。 UnexpectedClientError
43015 412 無法開始視訊,媒體串流要求逾時。允許瀏覽器提示存取相機使用權限,然後再試一次。 ExpectedError 如果使用者未對瀏覽器的使用權限提示採取動作,以允許存取攝影機,便會發生此錯誤。
43016 412 無法開始視訊,系統拒絕使用權限。 確保已允許瀏覽器設定和系統設定中視訊裝置的存取權限。 ExpectedError - 確保已允許瀏覽器設定和裝置系統設定中攝影機的存取權限。
- 確保在裝置系統設定中攝影機不會遭到停用。
- 在 macOS 上,確保系統設定允許螢幕錄製。

實用連結:
- 要求裝置權限
-macOS 上的螢幕共用權限
- 在 macOS 和 iOS 上列舉或存取 Safari 的裝置
43017 412 無法開始視訊,不支援的串流。 請再試一次,如果問題持續發生,請連絡 Azure 通訊服務支持人員。 UnexpectedClientError
43018 412 無法開始視訊,無法設定條件約束。 請再試一次,如果問題持續發生,請連絡 Azure 通訊服務支持人員。 UnexpectedClientError 深入了解如何設定視訊條件約束
43019 412 無法開始視訊,尚未選取裝置。 請確保傳遞使用 VideoDeviceInfo 建構的 LocalVideoStream,然後再試一次。 如果問題持續發生,請連絡 Azure 通訊服務支援人員。 UnexpectedClientError 實用連結:
- 使用視訊相機撥打電話
- 在通話時開始和停止傳送本機視訊
43200 412 無法轉譯視訊串流,無法使用此串流。 訂閱資料流的 isAvailable 屬性,讓遠端參與者在其影片開啟且串流可供轉譯時收到通知。 ExpectedError 實用連結:
- 轉譯遠程參與者視訊/螢幕畫面分享串流
- 為應用程式新增 1:1 視訊通話功能
- 訂閱 SDK 事件
43202 404 無法轉譯視訊串流,無法更長時間使用此串流。 遠端參與者已關閉影片。 ExpectedError 遠端參與者在嘗試為視訊建立檢視時,關閉了其視訊。
43203 408 無法轉譯視訊串流,轉譯在等候視訊畫面時逾時。 請再試一次,如果問題持續發生,請連絡 Azure 通訊服務支持人員。 UnexpectedClientError
43204 500 無法轉譯視訊串流,無法在 Azure 通訊服務基礎結構上訂閱影片。 請再試一次,如果問題持續發生,請連絡 Azure 通訊服務支持人員。 UnexpectedClientError
43209 405 無法轉譯視訊串流,VideoStreamRenderer 在初始化流程期間已處置。 ExpectedError
43210 400 無法處置 VideoStreamRenderer,因為已完成處置。 ExpectedError
43220 400 無法建立檢視,已達到使用中 RemoteVideoStream 檢視的數目上限。 您可以處置先前的檔案,以建立新檔案。 ExpectedError 深入了解如何正確支援傳入的視訊串流最佳數目
480 遠端用戶端端點未註冊。 請確定遠端端點可供使用。
481 無法處理傳入的通話。 透過 Azure 入口網站提出支援要求。
487 通話已取消、在本機遭到拒絕或已結束,因為端點不符或無法產生媒體供應項目。 預期的行為。
490、491、496、497、498 本機端點網路問題。 檢查您的網路。
503、504 通訊服務基礎結構錯誤。 透過 Azure 入口網站提出支援要求。
600 在任何地方顯示忙碌。 已成功連絡參與者,但傳回忙碌訊號。 預期的行為。
603 遠端通訊服務參與者的全域通話遭到拒絕。 預期的行為。
604 不存在任何地方。 要求的 URI 不存在。 預期的行為。
606 無法接受。 已成功連絡參與者,但所述的工作階段不受支援。 預期的行為。

了解呼叫程式碼和子程式碼的錯誤

錯誤碼、子程式碼和對應的結果類別可協助開發人員識別和診斷錯誤。 通話結束之後,這些錯誤碼會透過 call.callEndReason 屬性來公開。

錯誤碼詳細資料包括:

程式碼 - 代表用戶端或伺服器回應狀態的 3 位數整數。 錯誤碼類別:

  • 成功回應 (200-299)
  • 用戶端錯誤 (400-499)
  • 伺服器錯誤 (500-599)
  • 全域錯誤 (600-699)

子程式代碼 - 定義為整數,其中每個數位代表一個唯一原因,特定案例或特定案例結果群組。

訊息 - 用於描述結果,並在結果失敗時提供如何減輕問題的指示。

ResultCategory - 表示錯誤的類型。 視內容而定,值可以是 SuccessExpectedErrorUnexpectedClientErrorUnexpectedServerError

通話結束通話代碼和子程式碼

通話結束的原因有不同的說明。 以下是通話代碼結尾和子程式碼的意義,這些代碼會顯示通話的結束方式。

子代碼 代碼 訊息 結果類別 建議
0 0 已由本機參與者順利結束通話。 Success
0 487 已順利結束通話,因為來電者已取消通話。 Success
0 603 已順利結束通話,因為已遭受話方拒絕。 成功 通話已結束,因為目標使用者已透過用戶端 SDK、通話自動化、Graph、PSTN 或 Teams 拒絕函式拒絕。
7 496 呼叫在用戶端中斷網路連線時突然結束,儘管重試多次,但無法連線 ExpectedError 瀏覽器已離線或有網路問題。 檢查瀏覽器的網路連線,然後重試。
3100 410 由於用戶端上發生非預期的網路問題,呼叫設定失敗,請檢查用戶端的網路並重試。 UnxpectedClientError 檢查網路設定,確定它遵循 Azure 通訊通話網路 需求
3101 410 由於用戶端上發生非預期的網路問題,所以呼叫已中斷,請檢查客戶端的網路並重試。 UnxpectedClientError 檢查網路設定,確定它遵循 Azure 通訊通話網路 需求
3111 410 通話設定失敗,連線通話時無法處理媒體供應專案。 UnxpectedClientError 然後再試一次。 如果問題持續發生,請收集通話資訊用戶端記錄瀏覽器控制台記錄,並連絡 Azure 通訊服務 支援。
3112 410 由於用戶端上的網路設定問題、檢查客戶端的網路設定,然後重試,呼叫安裝程序失敗。 ExpectedError
4097 0 已結束會議召集人對所有使用者的通話。 成功
4,502 490 呼叫失敗,因為網路連線問題,瀏覽器無法完成網路 HTTP 要求。 UnexpectedClientError 用戶端無法完成 HTTP 要求和回應。 然後再試一次。 如果問題持續發生,請收集通話資訊用戶端記錄瀏覽器控制台記錄,並連絡 Azure 通訊服務 支援。
4506 408 通話逾時。檢查被呼叫者是否已收到並接受通話。 UnexpectedClientError 然後再試一次。 如果問題持續發生,請收集通話資訊用戶端記錄瀏覽器控制台記錄,並連絡 Azure 通訊服務 支援。
4507 495 已結束通話,因為應用程式未提供有效的 Azure 通訊服務權杖。 UnexpectedClientError 請確保您的應用程式正確實作權杖重新整理機制。
4521 0 通話因使用者突然中斷通話連線而結束。 這可能是使用者關閉了裝載通話的應用程式所致,例如,使用者未正確掛斷即關閉瀏覽器索引標籤,因而終止了應用程式。 ExpectedError
5000 0 已結束此參與者的通話。 另一個參與者已從交談中移除參與者。 成功
5003 0 已順利結束呼叫,因為所有被呼叫者皆拒絕呼叫。 成功
5300 0 這名參與者的通話已結束,因為另一名參與者將其從交談中移除。 成功 當另一個參與者移除此參與者時,呼叫已結束,可能是另一個用戶端、呼叫自動化 API、圖形 API。
5,317 0 目標參與者因參與者角色更新而遭到移除。 ExpectedError
5828 403 因為使用者不是受邀者清單的一部分,因此未獲得會議室會議的授權。 UnexpectedClientError
5829 403 會議結束時間或會議開始時間之前,不允許會議室會議加入。 UnexpectedClientError
5830 403 僅允許通訊服務使用者加入會議室會議。 ExpectedError
7000 0 呼叫已由 Azure 通訊服務呼叫自動化 API 或伺服器 Bot 結束。 成功 呼叫已由 ACS 呼叫自動化 API 或 Graph Bot 結束。
10003 487 此用戶端點的呼叫已取消,因為另一個端點已在其他地方接受。 成功 已起始呼叫目標使用者(開始通話、新增參與者、轉移),目標用戶同時有多個作用中端點,其中一個端點使用者接受呼叫。 這是一般行為,只有一個端點可以接受並連線到呼叫。 所有其他端點都會接收子碼 10003,表示已接受呼叫。
10004 487 通話在逾時時取消,因為目標使用者未及時接受或拒絕。 請確定使用者看到通知和/或應用程式可以自動處理,並嘗試再次起始該呼叫。 ExpectedError 在預先定義的時間量(通常是 2 分鐘)後取消通話,因為目標使用者不接受或拒絕。
10009 401 未經驗證的身分識別。 請確定您的 Azure 通訊服務 令牌有效且未過期。 UnexpectedClientError
10024 487 通話已順利結束。 所有遭受話方端點拒絕的通話。 成功 嘗試再次撥打電話。
10037 480 目標用戶沒有任何向 ACS 註冊的端點。 請確定目標使用者至少有一個作用中的端點,且已上線。 ExpectedError 如果目標使用者使用 Azure 通訊服務 呼叫 SDK,請確定 SDK 在其用戶端應用程式中已成功初始化。 如果目標使用者是 Teams 使用者,請確定其用戶端已上線。 請確定目標使用者的標識碼(CommunicationUserIdentifier、MicrosoftTeamsUserIdentifier 或 MicrosoftTeamsBotIdentifier) 正確無誤。 如果 Graph API user 已將 屬性 department 設定為 Microsoft Communication Application Instance MicrosoftTeamsBotIdentifier ,則應該指定 。
10057 408 通話失敗,受話方無法完成通話設定,最有可能是受話方遺失網路或突然終止應用程式。 請確定用戶端已連線且可供使用。 ExpectedError
10076 480 目標用戶已註冊,但未在通話時上線。 請確定目標使用者至少有一個作用中的端點,且已上線。 ExpectedError 如果目標使用者使用 Azure 通訊服務 呼叫 SDK,請確定 SDK 已在其用戶端應用程式中順利初始化,且其端點已上線。 如果目標使用者是 Teams 使用者,請確定其用戶端已上線。
10077 480 目標使用者已向 ACS 和/或註冊推播通知,但在通話時並未上線。 請確定目標使用者至少有一個作用中的端點,且已上線。 ExpectedError 如果目標使用者使用 Azure 通訊服務 呼叫 SDK,請確定 SDK 已成功在用戶端應用程式中初始化,且其端點已上線。 如果應用程式利用推播通知,請確定已正確設定。 如果目標使用者是 Teams 使用者,請確定其用戶端已上線。
10078 480 遠端用戶端端點未註冊或無法連線。 請確定遠端用戶端端點已成功將網路要求傳送至 Azure 通訊服務。 ExpectedError - 如果目標使用者使用 Azure 通訊服務 呼叫 SDK,請確定 SDK 已成功在用戶端應用程式中初始化,且其端點已上線。 如果應用程式利用推播通知,請確定已正確設定。
- 如果目標使用者是 Teams 使用者,請確定其用戶端已上線。
301004 410 由於無法在通話設定期間建立與 Azure 通訊服務 基礎結構的媒體連線,因此 Azure 通訊服務 基礎結構已從通話中移除參與者。 檢查使用者的網路設定,包括局域網路、防火牆、VPN 設定,然後再試一次。 UnexpectedClientError 請確定使用者的網路已正確設定,請遵循「網路建議」公開檔。
301005 410 由於與相同基礎結構的媒體連線中斷,Azure 通訊服務基礎結構已從通話中移除參與者。 該情況通常會發生在參與者突然離開通話或失去網路連線。 如果參與者想要繼續通話,他們可以重新連線。 UnexpectedClientError 請確定您是在支援的環境中使用最新的 SDK。
540000 0 本機 PSTN 來電者已成功結束通話。 成功
510403 403 已結束通話,其先前標示為垃圾通話,現在已封鎖。 ExpectedError - 請確保您的通訊服務權杖有效且未過期。
- 確保在通話選項中傳入 AlternateId
540487 487 已順利結束通話,因為來電者已取消通話。 成功
560000 0 已由遠端 PSTN 參與者順利結束通話。 成功 可能的原因:
- 使用者已結束通話。
- 由媒體代理程式結束的通話。
560486 486 已結束通話,因為遠端 PSTN 參與者忙碌中。 撥打的號碼正在電話中,或發生技術性問題。 成功 - 如需直接路由通話,請檢查您的工作階段邊界控制記錄、設定和逾時設定。 可能的原因:呼叫的號碼已在通話中,或發生技術問題。
404 找不到通話。 確定您要通話的號碼 (或您要加入的通話號碼) 存在。
408 通話控制器逾時。 通話控制器因等候使用者端點的通訊協定訊息而逾時。 請確定用戶端已連線且可供使用。
410 本機媒體堆疊或媒體基礎結構錯誤。 請確定您是在支援的環境中使用最新的 SDK。
430 無法將訊息傳遞至用戶端應用程式。 請確定用戶端應用程式正在執行且可供使用。
480 遠端用戶端端點未註冊。 請確定遠端端點可供使用。
481 無法處理傳入的通話。 透過 Azure 入口網站提出支援要求。
490、491、496、497、498 本機端點網路問題。 檢查網路設定,確定它遵循 Azure 通訊通話網路 需求
500、503、504 通訊服務基礎結構錯誤。 透過 Azure 入口網站提出支援要求。