호출 코드 및 하위 코드 오류 이해
통화 SDK와 해당 서버 인프라는 통합 프레임워크를 사용하여 오류를 나타냅니다. 개발자는 오류 코드, 하위 코드 및 해당 결과 범주를 사용하여 이러한 오류를 더 쉽게 이해하고 오류가 발생한 이유와 향후 완화 방법에 대한 설명을 찾을 수 있습니다. 오류 결과에 대한 세부 정보는 다음과 같이 볼 수 있습니다.
코드는 클라이언트 또는 서버 응답의 응답 상태를 나타내는 3자리 정수로 모델링됩니다. 다음과 같이 분류됩니다.
- 성공적인 응답(200~299)
- 클라이언트 오류(400~499)
- 서버 오류(500~599)
하위 코드는 정수로 정의됩니다. 여기서 각 숫자는 시나리오 그룹 또는 특정 시나리오 결과와 관련된 고유한 이유를 나타냅니다.
메시지 결과를 설명하고, 결과가 실패할 경우 문제를 완화하는 방법에 대한 힌트를 제공합니다.
ResultCategory - 오류 형식을 나타냅니다. 컨텍스트에 따라 값은 Success, ExpectedError, UnexpectedClientError 또는 UnexpectedServerError일 수 있습니다.
Important
이 문서에 설명된 기능은 현재 공개 미리 보기로 제공됩니다. 이 미리 보기 버전은 서비스 수준 계약 없이 제공되며, 프로덕션 워크로드에는 권장되지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.
호출 코드 및 하위 코드 오류 이해
오류 코드, 하위 코드 및 해당 결과 범주는 개발자가 오류를 식별하고 진단하는 데 도움이 됩니다. 이러한 오류 코드는 통화가 종료된 후 call.callEndReason 속성을 통해 노출됩니다.
오류 코드 세부 정보에는 다음이 포함됩니다.
코드 - 클라이언트 또는 서버 응답 상태를 나타내는 3자리 정수입니다. 코드 범주:
- 성공적인 응답(200~299)
- 클라이언트 오류(400~499)
- 서버 오류(500~599)
- 전역 오류(600-699)
하위 코드 - 정수로 정의되며 여기서 각 숫자는 시나리오 그룹 또는 특정 시나리오 결과와 관련된 고유한 이유를 나타냅니다.
메시지 - 결과를 설명하고 결과가 실패할 경우 문제를 완화하는 방법에 대한 힌트를 제공합니다.
ResultCategory - 오류 형식을 나타냅니다. 컨텍스트에 따라 값은 Success, ExpectedError, UnexpectedClientError 또는 UnexpectedServerError일 수 있습니다.
Azure Communication Services 통화 SDK 클라이언트 오류 코드 및 하위 코드
클라이언트 오류의 경우 resultCategories 속성이 ExpectedError이면 SDK의 관점에서 오류가 예상됩니다. 이러한 오류는 일반적으로 사전 조건 오류(예: 앱에서 전달한 잘못된 인수) 또는 현재 시스템 상태에서 API 호출을 허용하지 않는 경우에 발생합니다. 애플리케이션은 오류 이유와 API 호출 논리를 확인해야 합니다.
| 하위 코드 | 코드 | 메시지 | 결과 범주 | 조언 |
|---|---|---|---|---|
| 40101 | 408 | CallAgent를 만들지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. |
UnexpectedClientError | |
| 40104 | 408 | CallAgent를 만들지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. |
UnexpectedClientError | |
| 40114 | 408 | Azure Communication Services 인프라에 연결하지 못했습니다. 다시 시도하고 브라우저의 네트워크 요청을 확인합니다. 요청이 계속 실패하면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. |
UnexpectedClientError | 자세한 내용은 네트워크 요구사항을 참조하세요. |
| 40115 | 412 | Azure Communication Services 인프라에 대한 연결을 초기화할 수 없는 CallAgent를 만들지 못했습니다. 다시 시도하고 브라우저의 네트워크 요청을 확인합니다. 요청이 계속 실패하면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. |
UnexpectedClientError | 자세한 내용은 네트워크 요구사항을 참조하세요. |
| 40216 | 500 | CallAgent를 만들지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 40228 | 409 | CallAgent를 생성하지 못했습니다. 이 ID와 연결된 CallAgent 인스턴스가 이미 존재합니다. 기존 CallAgent를 삭제하거나 다른 ID를 사용하여 새 CallAgent를 만듭니다. | ExpectedError | |
| 40230 | 409 | TeamsCallAgent를 생성하지 못했습니다. 이 ID와 연결된 TeamsCallAgent 인스턴스가 이미 존재합니다. 새 TeamsCallAgent를 만들기 전에 기존 TeamsCallAgent를 삭제합니다. | ExpectedError | |
| 40606 | 405 | 스피커를 열거하지 못했습니다. Android Chrome, iOS Safari 또는 macOS Safari에서 스피커를 열거/선택하는 것은 지원되지 않습니다. | ExpectedError | Android Chrome, iOS Safari 및 macOS Safari에서는 스피커 열거/선택이 지원되지 않습니다. 운영 체제에서 스피커(출력 디바이스)를 자동으로 선택합니다. 디바이스 관리 및 이러한 문제를 가장 잘 완화하는 방법에 대해 자세히 알아보세요. |
| 40613 | 400 | 마이크 및/또는 카메라 사용 권한을 가져오지 못했거나, 거부되었거나 실패했습니다. 브라우저 및 OS 설정에서 사용 권한을 허용해야 합니다. | ExpectedError | 디바이스 사용 권한을 가장 잘 처리하는 방법에 대해 자세히 알아보세요. |
| 40614 | 500 | 디바이스 사용 권한을 요청하지 못했습니다. 브라우저 설정 및 OS 설정에서 사용 권한을 허용하고 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | 디바이스 사용 권한을 가장 잘 처리하는 방법에 대해 자세히 알아보세요. |
| 41006 | 400 | 수신 전화를 수락하지 못했습니다. 벨이 울리는 상태가 아닙니다. CallAgent의 incomingCall 이벤트를 구독하여 수신 전화를 수락합니다. |
ExpectedError | 문제의 근본 원인을 확인하려면 다음 문서를 참조하세요. - 수신 전화 받기 - SDK 이벤트 구독 |
| 41007 | 400 | 수신 전화를 거부하지 못했습니다. 벨이 울리는 상태가 아닙니다. CallAgent의 incomingCall 이벤트를 구독하여 수신 전화를 거부합니다. |
ExpectedError | 문제의 근본 원인을 확인하려면 다음 문서를 참조하세요. - 수신 전화 받기 - SDK 이벤트 구독 |
| 41015 | 500 | 마이크를 음소거하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 41016 | 400 | 마이크 음소거를 해제하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 41025 | 400 | 비디오를 시작하지 못했습니다. LocalVideoStream 인스턴스가 잘못되었거나 비어 있습니다. LocalVideoStream 인스턴스를 전달합니다. | ExpectedError | 비디오를 시작하기 위해 전달된 개체가 LocalVideoStream의 인스턴스인지 확인합니다. VideoDeviceInfo 개체 또는 MediaStream 개체를 사용하여 LocalVideoStream을(를) 생성합니다. 문제의 근본 원인을 확인하려면 다음 문서를 참조하세요. - 비디오 카메라로 전화 걸기 - 통화 중 로컬 비디오 보내기 시작 및 중지 - 원시 비디오 액세스 |
| 41027 | 400 | 비디오를 시작하지 못했습니다. 비디오가 이미 시작되었습니다. | ExpectedError | 유용한 링크: - 비디오 카메라로 전화 걸기 - 통화 중 로컬 비디오 보내기 시작 및 중지 |
| 41030 | 400 | 비디오를 시작하지 못했습니다. 비디오가 이미 중지되었습니다. | ExpectedError | 유용한 링크: - 비디오 카메라로 전화 걸기 - 통화 중 로컬 비디오 보내기 시작 및 중지 |
| 41032 | 400 | 비디오를 중지하지 못했습니다. 잘못된 인수입니다. 입력으로 사용되는 LocalVideoStream은 현재 전송되지 않습니다. | ExpectedError | 통화에서 전송되는 LocalVideoStream은 Call.localVideoStreams[] 배열에 저장되며 Video 또는 RawMedia 형식입니다. 문제의 근본 원인을 확인하려면 다음 문서를 참조하세요. - 비디오 카메라로 전화 걸기 - 통화 중 로컬 비디오 보내기 시작 및 중지 - 원시 비디오 액세스 |
| 41033 | 500 | 통화를 보류하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 41034 | 500 | 통화를 다시 시작하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 41035 | 400 | 화면 공유를 시작하지 못했습니다. 화면 공유가 이미 시작되었습니다. | ExpectedError | 통화 중 화면 공유를 시작 및 중지하는 방법에 대해 자세히 알아보기 |
| 41041 | 400 | 화면 공유를 중지하지 못했습니다. 화면 공유가 이미 중지되었습니다. | ExpectedError | 통화 중 화면 공유를 시작 및 중지하는 방법에 대해 자세히 알아보기 |
| 41048 | 410 | 통화 설정 프로세스 중에 비디오를 시작하지 못했습니다. 브라우저의 설정 및 OS 설정에서 비디오 사용 권한을 허용하고 카메라 디바이스가 다른 프로세스에서 사용되지 않는지 확인합니다. | UnexpectedClientError | - 시스템에서 카메라 디바이스를 사용하지 않도록 설정했을 수 있습니다. - 카메라가 다른 프로세스에서 사용되고 있습니다. |
| 41056 | 412 | 통화 시작 또는 참가에 실패했습니다. Teams Enterprise 음성 정책은 이 Azure Communication Services 리소스에 대해 사용하도록 설정되지 않았습니다. 온라인으로 자습서를 수행하여 사용하도록 설정합니다. | ExpectedError | Teams Enterprise 음성 정책을 사용하도록 설정하기 위해 사용자가 Enterprise Voice 온라인 및 전화 시스템 음성사서함을 사용하도록 설정하는 방법을 참조하세요. |
| 41071 | 412 | 화면 공유를 시작하지 못했습니다. 통화가 연결된 상태가 아닙니다. 통화가 연결되는 때를 알도록 통화의 stateChanged 이벤트를 구독합니다. |
ExpectedError | 유용한 링크: - 통화 속성 확인 - SDK 이벤트 구독 |
| 41073 | 412 | 사용자 지정 MediaStream을 다운로드하거나 설정하지 못했습니다. 이 기능은 현재 Azure Communication Services에서 사용할 수 없습니다. | ExpectedError | |
| 43000 | 412 | 비디오를 시작하지 못했습니다. 비디오 디바이스가 다른 프로세스/애플리케이션에서 사용되고 있습니다. 카메라가 다른 프로세스/애플리케이션에서 사용되지 않도록 하고 다시 시도하세요. | ExpectedError | 다른 프로세스에서 사용 중인 카메라를 가장 잘 처리하는 방법에 대해 자세히 알아보기 |
| 43001 | 403 | 비디오를 시작하지 못했습니다. 선택한 비디오 디바이스를 사용할 수 있는 권한이 부여되지 않았습니다. 브라우저의 설정 및 시스템 설정에서 비디오 디바이스 사용 권한이 허용되는지 확인합니다. | ExpectedError | 브라우저 설정 및 디바이스 시스템 설정에서 카메라 사용 권한이 허용되는지 확인합니다. 디바이스 시스템 설정에서 카메라를 사용하지 않도록 설정하지 않았는지 확인합니다. macOS에서 시스템 설정에서 화면 녹화가 허용되는지 확인합니다. 유용한 링크: - 디바이스 권한 요청- macOS의 화면 공유 권한 - macOS 및 iOS에서 Safari용 디바이스 열거 또는 액세스 |
| 43002 | 500 | 비디오를 시작하지 못했습니다. 알 수 없는 오류입니다. 다시 시도하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 43004 | 400 | 비디오 디바이스를 전환하지 못했습니다. 입력이 잘못되었습니다. 입력은 VideoDeviceInfo 형식이어야 합니다. | ExpectedError | 디바이스 관리자를 사용하여 VideoDeviceInfo 개체 목록을 가져와서 VideoDeviceInfo 개체를 사용하여 원본을 전환합니다. 통화 중 로컬 비디오 보내기 시작 및 중지하는 방법을 자세히 알아보기 |
| 43005 | 400 | 비디오 디바이스를 전환하지 못했습니다. 동일한 비디오 디바이스로 전환할 수 없습니다. 이미 선택되어 있습니다. | ExpectedError | |
| 43013 | 412 | 비디오를 시작하지 못했습니다. 비디오 디바이스를 찾을 수 없습니다. 비디오 디바이스가 시스템 설정에 연결되고 사용하도록 설정되어 있는지 확인합니다. | ExpectedError | 디바이스에 카메라가 연결되어 있고 설치되어 있는지 확인합니다. |
| 43014 | 412 | 비디오를 시작하지 못했습니다. 미디어 스트림을 요청하는 동안 오류가 발생했습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 43015 | 412 | 비디오를 시작하지 못했습니다. 미디어 스트림 요청 시간이 초과되었습니다. 카메라에 액세스하려면 브라우저의 프롬프트에 대한 사용 권한을 허용하고 다시 시도하세요. | ExpectedError | 이 오류는 사용자가 브라우저의 사용 권한 프롬프트에서 카메라에 대한 액세스를 허용하는 작업을 수행하지 않는 경우에 발생할 수 있습니다. |
| 43016 | 412 | 비디오를 시작하지 못했습니다. 시스템에서 사용 권한을 거부했습니다. 브라우저의 설정 및 시스템 설정에서 비디오 디바이스 사용 권한이 허용되는지 확인합니다. | ExpectedError | - 브라우저 설정 및 디바이스 시스템 설정에서 카메라 권한이 허용되는지 확인합니다. - 디바이스 시스템 설정에서 카메라를 사용하지 않도록 설정하지 않았는지 확인합니다. - macOS에서 시스템 설정에서 화면 녹화가 허용되는지 확인합니다. 유용한 링크: - 디바이스 권한 요청 -macOS의 화면 공유 권한 - macOS 및 iOS에서 Safari용 디바이스 열거 또는 액세스 |
| 43017 | 412 | 비디오를 시작하지 못했습니다. 지원되지 않는 스트림입니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 43018 | 412 | 비디오를 시작하지 못했습니다. 제약 조건을 설정하지 못했습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | 비디오 제약 조건을 설정하는 방법에 대해 자세히 알아보기 |
| 43019 | 412 | 비디오를 시작하지 못했습니다. 디바이스가 선택되지 않았습니다. VideoDeviceInfo로 생성된 LocalVideoStream을 전달하고 다시 시도하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | 유용한 링크: - 비디오 카메라로 전화 걸기 - 통화 중 로컬 비디오 보내기 시작 및 중지 |
| 43200 | 412 | 비디오 스트림을 렌더링하지 못했습니다. 이 스트림을 사용할 수 없습니다. 스트림의 isAvailable 속성을 구독하여 원격 참가자가 비디오를 켜고 스트림을 렌더링할 수 있을 때 알림을 받습니다. | ExpectedError | 유용한 링크: - 원격 참가자 비디오/화면 공유 스트림 렌더링 - 앱에 1:1 영상 통화 추가 - SDK 이벤트 구독 |
| 43202 | 404 | 비디오 스트림을 렌더링하지 못했습니다. 이 스트림은 더 이상 사용할 수 없습니다. 원격 참가자가 비디오를 껐습니다. | ExpectedError | 원격 참가자가 비디오를 보기로 만드는 동안 비디오를 껐습니다. |
| 43203 | 408 | 비디오 스트림을 렌더링하지 못했습니다. 비디오 프레임을 기다리는 동안 렌더링 시간이 초과되었습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 43204 | 500 | 비디오 스트림을 렌더링하지 못했습니다. Azure Communication Services 인프라에서 비디오를 구독하지 못했습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. | UnexpectedClientError | |
| 43209 | 405 | 비디오 스트림을 렌더링하지 못했습니다. 초기화 프로세스 중에 VideoStreamRenderer가 삭제되었습니다. | ExpectedError | |
| 43210 | 400 | VideoStreamRenderer가 이미 삭제되었기 때문에 삭제하지 못했습니다. | ExpectedError | |
| 43220 | 400 | 이미 도달한 활성 RemoteVideoStream 보기의 최대 수인 보기를 만들지 못했습니다. 새 항목을 만들기 위해 이전 항목을 삭제할 수 있습니다. |
ExpectedError | 가장 많은 수신 비디오 스트림을 올바르게 지원하는 방법에 대해 자세히 알아보기 |
| 480 | 원격 클라이언트 엔드포인트가 등록되지 않았습니다. | 원격 엔드포인트를 사용할 수 있는지 확인합니다. | ||
| 481 | 들어오는 호출을 처리하지 못했습니다. | Azure Portal을 통해 지원 요청을 제출합니다. | ||
| 487 | 엔드포인트 불일치 문제로 인해 통화가 취소되거나, 로컬에서 거부되거나, 종료되었거나 미디어 제품을 생성하지 못했습니다. | 예상 동작. | ||
| 490, 491, 496, 497, 498 | 로컬 엔드포인트 네트워크 문제. | 네트워크를 확인합니다. | ||
| 503, 504 | Communication Services 인프라 오류입니다. | Azure Portal을 통해 지원 요청을 제출합니다. | ||
| 600 | 어디서나 통화할 수 있습니다. 참가자에게 성공적으로 연락했지만 통화 중 신호음이 반환되었습니다. | 예상 동작. | ||
| 603 | 원격 Communication Services 참가자가 전역적으로 거부한 호출입니다. | 예상 동작. | ||
| 604 | 어디에도 존재하지 않습니다. 요청된 URI가 없습니다. | 예상 동작. | ||
| 606 | 허용되지 않습니다. 참가자에게 성공적으로 연락했지만 설명된 세션을 지원할 수 없습니다. | 예상 동작. |
호출 코드 및 하위 코드 오류 이해
오류 코드, 하위 코드 및 해당 결과 범주는 개발자가 오류를 식별하고 진단하는 데 도움이 됩니다. 이러한 오류 코드는 통화가 종료된 후 call.callEndReason 속성을 통해 노출됩니다.
오류 코드 세부 정보에는 다음이 포함됩니다.
코드 - 클라이언트 또는 서버 응답 상태를 나타내는 3자리 정수입니다. 코드 범주:
- 성공적인 응답(200~299)
- 클라이언트 오류(400~499)
- 서버 오류(500~599)
- 전역 오류(600-699)
하위 코드 - 정수로 정의되며 여기서 각 숫자는 시나리오 그룹 또는 특정 시나리오 결과와 관련된 고유한 이유를 나타냅니다.
메시지 - 결과를 설명하고 결과가 실패할 경우 문제를 완화하는 방법에 대한 힌트를 제공합니다.
ResultCategory - 오류 형식을 나타냅니다. 컨텍스트에 따라 값은 Success, ExpectedError, UnexpectedClientError 또는 UnexpectedServerError일 수 있습니다.
통화 종료 코드 및 하위 코드 호출
통화가 종료된 이유에 대한 설명은 다양합니다. 통화 종료 방법을 보여 주는 통화 종료 코드 및 하위 코드의 의미는 다음과 같습니다.
| 하위 코드 | 코드 | 메시지 | 결과 범주 | 조언 |
|---|---|---|---|---|
| 0 | 0 | 로컬 참가자가 통화를 성공적으로 종료했습니다. | Success | |
| 0 | 487 | 발신자가 통화를 취소하여 통화가 성공적으로 종료되었습니다. | Success | |
| 0 | 603 | 수신자가 거부하여 통화가 성공적으로 종료되었습니다. | Success | 호출이 클라이언트 SDK, 통화 자동화, 그래프, PSTN 또는 Teams 거부 함수를 통해 대상 사용자로부터 거부되었기 때문에 종료되었습니다. |
| 7 | 496 | 클라이언트가 갑자기 네트워크 연결을 끊고 여러 번 다시 시도했음에도 불구하고 연결할 수 없어 통화가 종료되었습니다. | ExpectedError | 브라우저가 오프라인 상태이거나 네트워크 문제가 있습니다. 브라우저의 네트워크 연결을 확인하고 다시 시도합니다. |
| 3100 | 410 | 클라이언트에서 예기치 않은 네트워크 문제로 인해 호출 설정이 실패하고 클라이언트의 네트워크를 확인하고 다시 시도합니다. | UnxpectedClientError | 네트워크 구성을 확인하고 Azure Communication Calling 네트워크 요구 사항을 따르는지 확인합니다. |
| 3101 | 410 | 클라이언트에서 예기치 않은 네트워크 문제로 인해 통화가 끊어졌으며 클라이언트의 네트워크를 확인하고 다시 시도합니다. | UnxpectedClientError | 네트워크 구성을 확인하고 Azure Communication Calling 네트워크 요구 사항을 따르는지 확인합니다. |
| 3111 | 410 | 통화 설정이 실패하여 통화를 연결하는 동안 미디어 제안을 처리할 수 없습니다. | UnxpectedClientError | 다시 시도하세요. 문제가 지속되면 통화 정보, 클라이언트 로그, 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. |
| 3112 | 410 | 클라이언트 쪽의 네트워크 구성 문제로 인해 호출 설정이 실패하고, 클라이언트의 네트워크 구성을 확인하고, 다시 시도합니다. | ExpectedError | 3112 의 하위 코드로 끝나는 통화에 대한 자세한 내용은 여기를 참조하세요. |
| 4097 | 0 | 모임 주최자가 모든 사용자의 통화를 종료했습니다. | Success | |
| 4502 | 490 | 네트워크 연결 문제로 인해 호출이 실패했고 브라우저에서 네트워크 HTTP 요청을 완료하지 못했습니다. | UnexpectedClientError | 클라이언트가 HTTP 요청 및 응답을 완료하지 못했습니다. 다시 시도하세요. 문제가 지속되면 통화 정보, 클라이언트 로그, 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. |
| 4506 | 408 | 통화 시간이 초과되었습니다. 발신자가 전화를 받고 수락했는지 확인합니다. | UnexpectedClientError | 다시 시도하세요. 문제가 지속되면 통화 정보, 클라이언트 로그, 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. |
| 4507 | 495 | 애플리케이션이 유효한 Azure Communication Services 토큰을 제공하지 않아 통화가 종료되었습니다. | UnexpectedClientError | 애플리케이션이 토큰 새로 고침 메커니즘을 올바르게 구현하는지 확인합니다. |
| 4521 | 0 | 사용자가 갑자기 통화 연결을 끊어 통화가 종료되었습니다. 이는 사용자가 적절한 중단 없이 브라우저 탭을 닫아 애플리케이션을 종료하는 등 호출을 호스트한 애플리케이션을 닫아서 발생할 수 있습니다. | ExpectedError | |
| 5000 | 0 | 이 참가자에 대한 통화가 종료되었습니다. 다른 참가자가 대화에서 참가자를 제거했습니다. | Success | |
| 5003 | 0 | 모든 수신자 엔드포인트가 통화를 거부하여 통화가 성공적으로 종료되었습니다. | Success | |
| 5300 | 0 | 다른 참가자가 대화에서 이 참가자를 제거하여 해당 참가자의 통화가 종료되었습니다. | Success | 다른 참가자가 이를 제거하면 이 참가자에 대한 호출이 종료되었으며, 다른 클라이언트인 Call Automation API, Graph API일 수 있습니다. |
| 5,317 | 0 | 참가자 역할 업데이트로 인해 대상 참가자가 제거됩니다. | ExpectedError | |
| 5828 | 403 | 사용자가 초대 대상 목록에 속하지 않으므로 채팅방 모임에 참가할 수 있는 권한이 없습니다. | UnexpectedClientError | |
| 5829 | 403 | 종료 시간 이후 또는 모임 시작 시간 이전에 회의실 모임에 참가할 수 없습니다. | UnexpectedClientError | |
| 5830 | 403 | Communication Services 사용자만 룸 모임에 참가할 수 있습니다. | ExpectedError | |
| 7000 | 0 | 호출은 Azure Communication Service Call Automation API 또는 서버 봇에 의해 종료되었습니다. | Success | 호출은 ACS 호출 자동화 API 또는 그래프 봇에 의해 종료되었습니다. |
| 10003 | 487 | 다른 엔드포인트에서 다른 곳에서 수락되었으므로 이 사용자 엔드포인트에 대한 호출이 취소되었습니다. | Success | 대상 사용자(통화 시작, 참가자 추가, 전송)에 대한 호출이 시작되었으며, 대상 사용자에게는 동시에 여러 활성 엔드포인트가 있었고, 엔드포인트 사용자 중 한 명이 통화를 수락했습니다. 이는 정상적인 동작이며, 하나의 엔드포인트만 호출을 수락하고 연결할 수 있습니다. 다른 모든 엔드포인트는 호출이 이미 수락되었음을 나타내기 위해 하위 코드 10003을 받습니다. |
| 10004 | 487 | 대상 사용자가 정시에 수락하거나 거부하지 않았기 때문에 시간 제한 시 통화가 취소되었습니다. 사용자가 알림 및/또는 애플리케이션이 자동으로 처리할 수 있는지 확인하고 해당 호출을 다시 시작합니다. | ExpectedError | 대상 사용자가 수락하거나 거부하지 않았기 때문에 미리 정의된 시간(일반적으로 2분) 후에 호출이 취소되었습니다. |
| 10009 | 401 | 인증되지 않은 ID입니다. Azure Communication Services 토큰이 유효하고 만료되지 않았는지 확인합니다. | UnexpectedClientError | |
| 10024 | 487 | 통화가 종료되었습니다. 모든 수신자 엔드포인트에서 통화가 거부되었습니다. | Success | 통화를 다시 시도합니다. |
| 10037 | 480 | 대상 사용자에게 ACS에 등록된 엔드포인트가 없습니다. 대상 사용자에게 활성 엔드포인트가 하나 이상 있고 온라인 상태인지 확인합니다. | ExpectedError | 대상 사용자가 Azure Communication Services 통화 SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되었는지 확인합니다. 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다. 대상 사용자의 식별자(CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier 또는 MicrosoftTeamsBotIdentifier)가 올바른지 확인합니다. Graph API user 에 속성 department 이 설정된 Microsoft Communication Application Instance MicrosoftTeamsBotIdentifier 경우 지정해야 합니다. |
| 10057 | 408 | 통화가 실패했거나, 수신자가 통화 설정을 완료하지 못했거나, 대부분의 경우 수신자의 네트워크가 끊겼거나, 애플리케이션을 갑자기 종료했습니다. 클라이언트가 연결되어 있고 사용 가능한지 확인합니다. | ExpectedError | |
| 10076 | 480 | 대상 사용자가 등록되었지만 통화 당시에는 온라인 상태가 아니었습니다. 대상 사용자에게 활성 엔드포인트가 하나 이상 있고 온라인 상태인지 확인합니다. | ExpectedError | 대상 사용자가 Azure Communication Services 통화 SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되고 해당 엔드포인트가 온라인 상태인지 확인합니다. 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다. |
| 10077 | 480 | 대상 사용자가 ACS 및/또는 푸시 알림에 등록되었지만 통화 당시에는 온라인 상태가 아니었습니다. 대상 사용자에게 활성 엔드포인트가 하나 이상 있고 온라인 상태인지 확인합니다. | ExpectedError | 대상 사용자가 Azure Communication Services 통화 SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되고 해당 엔드포인트가 온라인 상태인지 확인합니다. 애플리케이션이 푸시 알림을 활용하는 경우 올바르게 구성되었는지 확인합니다. 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다. |
| 10078 | 480 | 원격 클라이언트 엔드포인트가 등록되지 않았거나 연결할 수 없습니다. 원격 클라이언트 엔드포인트가 Azure Communication Services에 네트워크 요청을 성공적으로 보내고 있는지 확인합니다. | ExpectedError | - 대상 사용자가 Azure Communication Services Calling SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되고 해당 엔드포인트가 온라인 상태인지 확인합니다. 애플리케이션이 푸시 알림을 활용하는 경우 올바르게 구성되었는지 확인합니다. - 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다. |
| 301004 | 410 | 통화 설정 중에 Azure Communication Services 인프라와의 미디어 연결을 설정할 수 없어서 참가자가 Azure Communication Services 인프라에 의해 호출에서 제거되었습니다. 로컬 네트워크, 방화벽, VPN 구성을 비롯한 사용자의 네트워크 구성을 확인하고 다시 시도합니다. | UnexpectedClientError | 사용자의 네트워크가 올바르게 구성되었는지 확인하려면 '네트워크 권장 사항' 공개 설명서를 따르세요. |
| 301005 | 410 | 동일한 인프라를 사용한 미디어 연결 손실로 인해 Azure Communication Services 인프라의 호출에서 참가자가 제거되었습니다. 이는 일반적으로 참가자가 갑자기 전화를 끊거나 네트워크 연결이 끊어지는 경우에 발생합니다. 참가자는 통화를 계속하려면 다시 연결할 수 있습니다. | UnexpectedClientError | 지원되는 환경에서 최신 SDK를 사용하고 있는지 확인합니다. |
| 540000 | 0 | 로컬 PSTN 호출자가 호출을 성공적으로 종료했습니다. | Success | |
| 510403 | 403 | 통화가 종료되고 이전에 스팸으로 표시되어 이제 차단되었습니다. | ExpectedError | - Communication Services 토큰이 유효하고 만료되지 않았는지 확인합니다. - 통화 옵션에서 AlternateId을(를) 전달해야 합니다. |
| 540487 | 487 | 발신자가 통화를 취소하여 통화가 성공적으로 종료되었습니다. | Success | |
| 560000 | 0 | 원격 PSTN 참가자가 통화를 성공적으로 종료했습니다. | Success | 가능한 원인: - 사용자가 통화를 종료했습니다. - 미디어 에이전트가 통화를 종료했습니다. |
| 560486 | 486 | 원격 PSTN 참가자가 통화 중이어서 통화가 종료되었습니다. 전화를 건 번호는 이미 통화 중이거나 기술적인 문제가 있는 번호입니다. | Success | - 직접 라우팅 통화의 경우 세션 경계 제어 로그와 설정 및 시간 제한 구성을 확인합니다. 가능한 원인: 호출된 번호가 이미 통화 중이거나 기술적인 문제가 발생했습니다. |
| 404 | 호출을 찾을 수 없습니다. | 통화하는 번호(또는 조인하는 통화)가 있는지 확인합니다. | ||
| 408 | 통화 컨트롤러 시간이 초과되었습니다. | 사용자 엔드포인트에서 프로토콜 메시지를 기다리는 동안 통화 컨트롤러 시간이 초과되었습니다. 클라이언트가 연결되어 있고 사용 가능한지 확인합니다. | ||
| 410 | 로컬 미디어 스택 또는 미디어 인프라 오류입니다. | 지원되는 환경에서 최신 SDK를 사용하고 있는지 확인합니다. | ||
| 430 | 클라이언트 애플리케이션에 메시지를 전달할 수 없습니다. | 클라이언트 애플리케이션이 실행 중이고 사용 가능한지 확인합니다. | ||
| 480 | 원격 클라이언트 엔드포인트가 등록되지 않았습니다. | 원격 엔드포인트를 사용할 수 있는지 확인합니다. | ||
| 481 | 들어오는 호출을 처리하지 못했습니다. | Azure Portal을 통해 지원 요청을 제출합니다. | ||
| 490, 491, 496, 497, 498 | 로컬 엔드포인트 네트워크 문제. | 네트워크 구성을 확인하고 Azure Communication Calling 네트워크 요구 사항을 따르는지 확인합니다. | ||
| 500, 503, 504 | Communication Services 인프라 오류입니다. | Azure Portal을 통해 지원 요청을 제출합니다. |