다음을 통해 공유


UI 라이브러리 사용 사례

Azure Communication Services UI 라이브러리의 구성 요소 및 복합 요소를 사용하여 애플리케이션의 통화 및 채팅 환경을 만듭니다.

복합 요소의 통화 및 채팅 기능은 애플리케이션에 복합 요소를 통합하면 직접 빌드되고 노출됩니다. UI 구성 요소에서 통화 및 채팅 기능은 UI 기능과 기본 상태 저장 라이브러리의 조합을 통해 노출됩니다. 이러한 기능을 완벽하게 활용하려면 상태 저장 통화 및 채팅 클라이언트 라이브러리와 함께 UI 구성 요소를 사용하는 것이 좋습니다.

UI 라이브러리 스토리북에서 더 많은 개념 설명서, 빠른 시작 및 예제를 확인하세요.

통화 사용 사례

지역 사용 사례
통화 유형 Microsoft Teams 모임 참가
그룹 ID를 사용하여 Azure Communication Services 통화에 참가
Azure Communication Services 에 참가
다른 Azure Communication Services 사용자에 대한 아웃바운드 통화 시작
전화 번호에 대한 아웃바운드 통화 시작
Teams 상호 운용성 통화 대기실에 참가
대화 내용 기록 및 녹음/녹화 경고 배너 표시
통화 컨트롤 통화 음소거 및 음소거 해제
통화 중 비디오 켜기 및 끄기
화면 공유 켜기
통화 종료
참가자 갤러리 그리드에 원격 참가자 표시
로컬 사용자에 대한 통화에서 비디오 미리 보기 제공
비디오가 꺼진 경우 기본 아바타 제공
참가자 갤러리에 공유 화면 콘텐츠 표시
통화 구성 마이크 디바이스 관리
카메라 디바이스 관리
스피커 디바이스 관리
사용자가 비디오를 확인할 수 있는 로컬 미리 보기 제공
참여자 참가자 명단 표시

채팅 사용 사례

지역 Azure Communication Services Chat Teams 상호 운용성 채팅
채팅 유형 Azure Communication Services 채팅 스레드에 참가 Microsoft Teams 모임 채팅에 참가
채팅 작업 문자 메시지 보내기 및 받기 문자 메시지 보내기 및 받기
서식 있는 문자 메시지 받기 서식 있는 문자 메시지 받기
- 인라인 이미지 받기*
첨부 파일 보내기 및 받기* 첨부 파일 받기*
채팅 이벤트 입력 표시기 보내기 및 받기 입력 표시기 보내기 및 받기**
수신 확인 보내기 및 받기 수신 확인 보내기 및 받기
참가자가 추가되거나 제거되면 표시 참가자가 추가되거나 제거되면 표시
참여자 참가자 명단 표시 참가자 명단 표시

*인라인 이미지 및 첨부 파일 지원은 현재 공개 미리 보기로 제공됩니다. 미리 보기 API 및 SDK는 서비스 수준 계약 없이 제공됩니다. 프로덕션 워크로드에는 사용하지 않는 것이 좋습니다. 일부 기능은 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure 미리 보기에 대한 보충 사용 약관을 검토하세요.

**Teams 사용자의 입력 이벤트 표시 이름이 제대로 표시되지 않을 수 있습니다.

지원되는 ID

복합 요소를 초기화하고 서비스에 인증하려면 사용자에게 Azure Communication Services ID가 있어야 합니다. 자세한 내용은 Azure Communication Services에 인증빠른 시작: 액세스 토큰 만들기 및 관리를 참조하세요.

Teams 상호 운용성

Teams 상호 운용성 시나리오의 경우 UI 라이브러리 복합 요소를 사용하여 Communication Services를 통한 Teams 모임에 사용자를 추가할 수 있습니다. Teams 상호 운용성을 사용하도록 설정하려면 통화 복합 요소 또는 채팅 복합 요소의 기본 기능을 사용하거나 UI 구성 요소를 사용하여 사용자 지정 환경을 빌드합니다.

애플리케이션에 통화 및 채팅을 모두 추가하면 참가자가 통화에 참가할 때까지 채팅 클라이언트를 초기화할 수 없다는 점을 기억해야 합니다. 참가자가 참가하면 채팅 클라이언트를 초기화하여 모임 채팅 스레드에 조인할 수 있습니다. 패턴은 다음 그림에 설명되어 있습니다.

Teams 통화 및 채팅의 상호 운용성 패턴을 보여 주는 다이어그램

UI 구성 요소를 사용하여 Teams 상호 운용성 환경을 제공하는 경우 먼저 UI 라이브러리 예제를 사용하여 환경의 주요 부분을 만듭니다.

  • 대기실 예제. 참가자가 통화에 참가할 때까지 대기할 수 있는 샘플 대기실입니다.
  • 규정 준수 배너. 사용자에게 통화가 녹음/녹화되고 있는지 보여 주는 샘플 배너입니다.
  • Teams 테마. UI 라이브러리 요소를 Microsoft Teams처럼 보이게 하는 샘플 테마입니다.
  • 이미지 공유*. Azure Communication Service 최종 사용자는 Teams 사용자가 보낸 이미지를 받을 수 있음을 보여주는 샘플
  • 파일 공유*. Azure Communication Service 최종 사용자는 Teams 사용자가 보낸 첨부 파일을 받을 수 있음을 보여주는 샘플

사용자 지정

UI 라이브러리 패턴을 사용하여 애플리케이션의 모양과 느낌에 맞게 구성 요소를 수정하세요. 사용자 지정은 Communication Services의 복합 구성 요소와 UI 구성 요소 간의 주요 차이점입니다. 복합 요소는 사용자 지정 옵션이 더 적으므로 통합 환경이 더 단순합니다.

다음 표에서는 사용자 지정 사용 사례의 복합 구성 요소와 UI 구성 요소를 비교합니다.

사용 사례 Composites UI 구성 요소
Fluent 기반 테마 사용 X X
환경 레이아웃 작성 X
CSS 스타일 지정을 사용하여 스타일 속성 수정 X
아이콘 바꾸기 X
참가자 갤러리 레이아웃 수정 X
호출 컨트롤 레이아웃 수정 X X
데이터 모델을 삽입하여 사용자 메타데이터 수정 X X

가시성

상태 저장 통화 및 채팅 클라이언트에 직접 액세스할 수 있도록 UI 라이브러리의 상태 관리 아키텍처가 분리됩니다. 상태 저장 클라이언트에 연결하여 상태를 읽고, 이벤트를 처리하고, 동작을 재정의하여 UI 구성 요소에 전달할 수 있습니다.

다음 표에서는 가시성 사용 사례의 복합 구성 요소와 UI 구성 요소를 비교합니다.

사용 사례 Composites UI 구성 요소
통화 및 채팅 클라이언트 상태에 액세스 X X
클라이언트 이벤트에 액세스하고 처리 X X
UI 이벤트에 액세스하고 처리 X X

Azure Communication Services 액세스 토큰을 사용하여 복합 요소 및 기본 구성 요소를 초기화합니다. 자신이 관리하는 신뢰할 수 있는 서비스를 통해 Communication Services에서 액세스 토큰을 가져오는 것이 중요합니다. 자세한 내용은 빠른 시작: 액세스 토큰 만들기 및 관리신뢰할 수 있는 서비스 자습서를 참조하세요.

권장되는 UI 라이브러리 아키텍처를 보여 주는 다이어그램

통화 및 채팅 클라이언트 라이브러리에는 참가하는 통화 또는 채팅에 대한 컨텍스트가 있어야 합니다. 사용자 액세스 토큰과 마찬가지로, 사용자 고유의 신뢰할 수 있는 서비스를 사용하여 클라이언트에 컨텍스트를 배포합니다.

다음 표에는 클라이언트 라이브러리에 컨텍스트를 추가하는 데 필요한 초기화 및 리소스 관리 기능이 요약되어 있습니다.

Contoso 책임 UI 라이브러리 책임
Azure에서 액세스 토큰 제공 제공된 액세스 토큰을 통과하여 구성 요소 초기화
새로 고침 함수 제공 개발자가 제공한 함수를 사용하여 액세스 토큰 새로 고침
통화 또는 채팅을 위한 참가 정보 검색 및 전달 통화 및 채팅 정보를 전달하여 구성 요소 초기화
사용자 지정 데이터 모델에 대한 사용자 정보 검색 및 전달 렌더링할 구성 요소에 사용자 지정 데이터 모델 전달

플랫폼 지원

SDK Windows macOS Ubuntu Linux Android iOS
UI SDK Chrome*, Microsoft Edge Chrome*, Safari** Chrome* Chrome* Chrome* Safari**

* Chrome의 현재 버전과 두 개의 이전 릴리스가 지원됩니다.

** Safari 13.1 이상 버전이 지원됩니다. Safari macOS에 대한 보내는 비디오는 아직 지원되지 않지만 iOS에서 지원됩니다. 보내는 화면 공유는 데스크톱 iOS에서만 지원됩니다.

접근성

설계상의 접근성은 Microsoft 제품에 대한 원칙입니다. UI 라이브러리는 이 원칙을 따르며, 모든 UI 구성 요소에 완전히 액세스할 수 있습니다.

지역화

지역화는 전 세계에 있는 다국어 사용자를 위한 제품을 만드는 데 중요합니다. UI 라이브러리는 오른쪽에서 왼쪽 언어를 포함하여 일부 언어 및 기능에 대한 기본 지원을 제공합니다. UI 라이브러리와 함께 사용할 자체 지역화 파일을 제공할 수 있습니다.

알려진 문제

  • 현재 UI 라이브러리는 기존 메시지를 편집할 때 메시지 유형 업데이트를 지원하지 않습니다. 기존 메시지에 서식 있는 텍스트 서식을 추가하면 텍스트 콘텐츠에 HTML 스타일이 추가됩니다. 이는 메시지 유형을 변경하지 않으므로 메시지 스레드에 html 콘텐츠가 일반 텍스트로 표시될 수 있습니다.

Azure Communication Services UI 라이브러리의 CallCompositeChatComposite를 사용하여 iOS 및 Android 애플리케이션에서 통화 환경을 만듭니다. 몇 줄의 코드를 사용하여 전체 통화 및 채팅 환경을 애플리케이션에 쉽게 통합할 수 있습니다. Communication Services의 컴포지트는 설정에서 통화 및 채팅 종료까지 통화 및 채팅의 전체 수명 주기를 관리합니다.

통화 사용 사례

Communication Services의 통화 복합 요소를 사용하여 다음 사용 사례를 만들 수 있습니다.

지역 사용 사례
통화 유형 Microsoft Teams 모임 참가
모임 ID와 암호를 사용하여 Microsoft Teams 모임 참가
그룹 ID를 사용하여 통화에 참가
회의실 ID를 사용하여 통화에 참가
1:1 통화 걸기 및 받기
Teams 상호 운용성 통화 대기실에 참가
대화 내용 기록 및 녹음/녹화 경고 배너 표시
로비 참가자 승인/거부
캡션을 Teams 상호 운용성
그룹 통화, 룸 통화 및 1:1 통화
참가자 갤러리 그리드에 원격 참가자 표시
로컬 사용자에 대한 통화에서 비디오 미리 보기 제공
비디오가 꺼진 경우 기본 아바타 제공
참가자 갤러리에 공유 화면 콘텐츠 표시
참가자 아바타 사용자 지정 사용
참가자 명단 표시
통화 구성 마이크 디바이스 관리
카메라 디바이스 관리
스피커 디바이스 관리(유선 또는 Bluetooth)
사용자가 비디오를 확인할 수 있는 로컬 미리 보기 제공
종료 통화 확인 대화 사용
설정 화면 건너뛰기
통화 컨트롤 통화 음소거 및 음소거 해제
통화 중 비디오 켜기 또는 끄기
통화 종료
오디오 중단 후 통화 보류 및 계속하기
CallKit 및 TelecomManager 지원

Teams 상호 운용성

Teams 상호 운용성 시나리오의 경우 UI 라이브러리 복합 요소를 사용하여 Communication Services를 통한 Teams 모임에 사용자를 추가할 수 있습니다. Teams 상호 운용성을 사용하도록 설정하려면 통화 복합 요소를 사용합니다. 이 복합 요소는 Teams 상호 운용성 통화 참가의 전체 수명 주기를 관리합니다.

Teams 통화 및 채팅의 상호 운용성 패턴을 보여 주는 다이어그램

다음 그림에서는 통화자가 Teams 모임에 추가되기 전의 사용자 환경 예제를 보여 줍니다.

통화자가 Teams 모임에 추가되기 전의 사용자 환경을 보여 주는 스크린샷

룸 통합

Azure Communication Services는 가상 약속 또는 가상 이벤트와 같은 구조화된 대화를 빌드하는 개발자를 위한 공간 개념을 제공합니다. 대화방은 현재 음성 및 영상 통화를 허용합니다.

회의실은 Azure Communication Services 최종 사용자 간의 작업을 관리하는 컨테이너입니다. 회의실은 애플리케이션 개발자가 통화에 참가할 수 있는 사용자, 모임 시기 및 협업 방법을 보다 잘 제어할 수 있도록 합니다. 회의실에 대한 자세한 내용은 개념 설명서를 참조하세요.

사용자는 다음 역할 중 3개 중 1로 룸 API를 사용하여 회의실에 초대됩니다.

  • 발표자(기본값)
  • 참석자
  • 소비자

각 역할 간의 구분은 회의실 호출 CallComposite중에 보유한 기능에 있습니다. 각 역할과 관련된 특정 기능은 여기에 자세히 설명되어 있습니다.

대화방 관리를 보여 주는 다이어그램

참고 항목

룸 API는 회의실을 만들고, 사용자를 관리하고, 방의 수명을 조정하는 용도로 사용됩니다. Rooms API는 UI 라이브러리와 별개인 백 엔드 서비스입니다.

폐쇄 자막

선택 자막을 사용하면 Teams와의 상호 운용성, Azure Communication Services 그룹 호출, 룸 호출 및 일대일 호출을 비롯한 다양한 시나리오를 사용할 수 있습니다. 이 기능을 사용하면 사용자가 다양한 통화 환경에서 대화를 따라가며 접근성 과 사용자 환경을 향상시킬 수 있습니다. 그러나 시스템에서 음성 언어를 자동으로 검색하지 않으므로 사용자가 기본적으로 UI 라이브러리를 사용하여 캡션의 언어를 수동으로 선택해야 합니다.

UI 라이브러리에서 선택 자막 통합 환경을 보여 주는 스크린샷

참고 항목

자막은 공개 미리 보기가 시작될 때 비용이 청구되지 않습니다. 이는 제한된 시간 동안만 적용되며, 6월부터 캡션 사용 요금이 청구될 예정입니다.

선택 자막 에 대한 자세한 정보를 보려면 설명서 및 사용 지침을 검토하세요. 또한 UI 라이브러리 내에서 직접 선택 자막의 구성으로 직접 이동하려는 경우 자습서를 따라 쉽게 설정할 수 있습니다.

공유 콘텐츠 보기

통화 참가자는 Teams 통화 중에 다른 참가자가 화면을 공유할 때 모바일 네이티브 플랫폼용 UI 라이브러리를 통해 공유 콘텐츠를 볼 수 있습니다. 원격 참가자는 스트레치 및 손가락 모으기 제스처를 사용하여 통화 중에 공유되는 콘텐츠를 확대 또는 축소할 수 있습니다.

테마

iOS 및 Android용 UI 라이브러리 통화 복합을 요소를 사용하여 통화자 환경의 사용자 지정 테마를 만들 수 있습니다. 플랫폼 환경을 만들려면 다음 표와 같이 테마 색 세트를 전달합니다. 자세한 내용은 테마를 만드는 방법을 참조하세요.

Android iOS
통화자 환경의 Android 테마를 보여 주는 스크린샷 통화자 환경의 iOS 테마를 보여 주는 스크린샷

화면 크기

Azure Communication Services 통화 복합 요소를 조정하여 화면 크기를 5인치에서 태블릿 크기로 조정할 수 있습니다. 통화 복합 요소에서 분할 모드 및 태블릿 모드를 사용하여 동적 참가자의 명단 레이아웃을 확인하고, 보기에 대한 명확성을 제공하고, 대화에 집중합니다.

분할 모드 태블릿 모드
분할 화면 보기를 보여 주는 스크린샷 태블릿 모드를 보여 주는 스크린샷

지역화

지역화는 전 세계에 있는 다국어 사용자를 위한 제품을 만드는 데 중요합니다. UI 라이브러리는 영어, 스페인어, 프랑스어, 독일어, 이탈리아어, 일본어, 한국어, 네덜란드어, 포르투갈어, 러시아어, 터키어 및 중국어를 포함한 12개 언어를 지원합니다. 또한 오른쪽에서 왼쪽 언어를 지원합니다. 자세한 내용은 앱에 지역화를 추가하는 방법을 참조하세요.

접근성

접근성은 통화 라이브러리의 핵심 과제입니다. 화면 읽기 프로그램을 사용하여 통화 상태에 대한 중요한 알림을 만들고, 시각 장애가 있는 사용자가 애플리케이션을 사용할 때 효과적으로 참여할 수 있도록 할 수 있습니다.

데이터 삽입 보기

모바일 네이티브 플랫폼용 UI 라이브러리를 사용하여 로컬 및 원격 참가자가 통화에서 사용자로 표시되는 방식을 사용자 지정할 수 있는 옵션을 제공합니다. 로컬 참가자는 통화가 시작될 때 설정 화면에서 로컬 아바타, 사용자 지정 표시 이름, 탐색 제목 및 자막을 선택할 수 있습니다. 원격 사용자는 모임에 참가할 때 사용자 지정된 아바타를 만들 수 있습니다. 자세한 내용은 모임 전 보기를 사용자 지정하는 방법을 참조하세요.

iOS의 모임 전 환경 및 참가 환경을 보여 주는 GIF 애니메이션

설정 화면 건너뛰기

UI 라이브러리는 통화 참가 환경의 설정 화면을 건너뛰고 통화에 참가할 수 있는 기능을 제공합니다. 기본적으로 사용자는 설정 화면을 통해 통화에 참가합니다. 여기서 사용자는 통화에 참가하기 전에 카메라 켜기 또는 끄기, 마이크 켜기 또는 끄기 및 오디오 디바이스 선택과 같은 통화 구성을 설정합니다. 이 화면에서는 통화에 참가하기 위해 사용자 상호 작용이 필요하며 일부 사용자에게는 설정이 필요하지 않을 수 있습니다. 따라서 Microsoft에서는 설정 화면을 건너뛰고 통화 구성 API를 제공하여 통화에 참가하는 기능을 제공합니다. 자세한 내용은 설정 건너뛰기 화면 기능 사용 방법을 참조하세요.

오디오 전용 모드

UI 라이브러리의 오디오 전용 모드를 사용하면 참가자는 동영상을 공유하거나 수신하지 않고 오디오만 사용하여 통화에 참여할 수 있습니다. 이 기능은 대역폭을 보존하고 개인 정보 보호를 최대화하는 데 사용됩니다. 활성화되면 오디오 전용 모드는 스트림 전송 및 수신 모두에 대한 동영상 기능을 자동으로 사용하지 않도록 설정하고 동영상 관련 컨트롤을 제거하여 이러한 변경 내용을 반영하도록 UI를 조정합니다. 이 모드는 CallComposite 구성을 통해 사용하도록 설정할 수 있으며 자세한 내용은 오디오 전용 빠른 시작을 통해 확인할 수 있습니다.

Orientation

UI 라이브러리는 라이브러리 환경을 시작하기 전에 각 화면에 대한 화면 방향 설정을 개별적으로 지원합니다. 이를 통해 애플리케이션 개발자는 애플리케이션 방향을 조정하는 통화 환경에 대해 고정 방향을 설정할 수 있습니다. Android 및 iOS 플랫폼에서 지원되는 방향 목록과 API 사용에 관한 자세한 내용은 방향 기능 사용 방법을 참조하세요.

멀티태스킹 및 화면 속 화면

UI 라이브러리는 통화 화면의 화면 속 화면 모드를 지원합니다. 통화하는 동안 사용자는 통화 화면에서 뒤로 버튼을 클릭하여 멀티태스킹을 사용하도록 설정하여 사용자를 이전 화면으로 되돌릴 수 있습니다. 화면 속 화면이 사용하도록 설정된 경우 통화에 시스템 화면 속 화면이 표시됩니다. Android와 iOS 플랫폼의 멀티태스킹과 PIP(화면 속 화면), API 사용에 관해 자세히 알아보려면 PIP(화면 속 화면) 사용 방법을 참조하세요.

CallKit 지원

UI 라이브러리는 CallKit 통합을 지원하여 통화를 위한 CallKit과의 상호 작용을 처리합니다. iOS 플랫폼 통합과 API 사용에 관한 자세한 내용은 CallKit 사용 방법을 참조하세요.

TelecomManager 지원

이제 UI 라이브러리는 TelecomManager와의 통합을 지원하여 통화 보류 및 다시 시작 함수를 처리할 수 있습니다. Android 플랫폼 통합 및 API 사용에 대해 자세히 알아보려면 TelecomManager 사용 방법을 참조하세요.

일대일 통화 및 푸시 알림 지원

UI 라이브러리는 통신 식별자를 통해 사용자에게 전화를 걸기 위한 일대일 VoIP 호출을 지원합니다. 들어오는 호출을 받기 위해 UI 라이브러리는 푸시 알림 등록도 지원합니다. Android와 iOS 플랫폼 통합과 API 사용에 관한 자세한 내용은 일대일 통화를 수행하고 푸시 알림을 수신하는 방법을 참조하세요.

통화 종료 프롬프트 사용 안 함

통화 기능을 통합하는 애플리케이션을 개발하는 경우 원활하고 직관적인 사용자 환경을 보장하는 것이 중요합니다. UX를 간소화할 수 있는 한 가지 영역은 통화 종료 프로세스입니다. 특히 개발자는 사용자가 통화를 종료하려고 할 때 표시되는 왼쪽 통화 확인 프롬프트를 사용하지 않도록 설정하는 것을 고려할 수 있습니다. 이 기능은 우발적인 통화 종료를 방지하는 데 유용하지만, 속도와 효율성이 특히 중요한 환경에서 사용자 경험에 방해가 될 수 있습니다. 통화 확인을 사용하지 않도록 설정하는 방법

신속한 통신 환경: 의사 결정과 행동을 신속하게 실행해야 하는 거래 시장, 긴급 콜 센터 또는 고객 서비스 센터와 같은 설정에서 통화 종료를 확인하는 추가 단계는 워크플로의 효율성을 저해할 수 있습니다.

채팅 사용 사례

Important

Azure Communication Services의 이 기능은 현재 미리 보기 상태입니다.

미리 보기 API 및 SDK는 서비스 수준 계약 없이 제공됩니다. 프로덕션 워크로드에는 사용하지 않는 것이 좋습니다. 일부 기능은 지원되지 않거나 기능이 제한될 수 있습니다.

자세한 내용은 Microsoft Azure 미리 보기에 대한 보충 사용 약관을 검토하세요.

지역 사용 사례
채팅 유형 Azure Communication Services 채팅 스레드에 참가
채팅 작업 채팅 메시지 보내기
채팅 메시지 받기
채팅 이벤트 입력 표시기 표시
읽음 확인 표시
참가자가 추가되거나 제거되면 표시
채팅 제목 변경 내용 표시

유연성

ChatComposite는 애플리케이션의 다양한 레이아웃과 보기에 맞도록 설계되었습니다. 예를 들어, 탐색 보기, 모달 보기 또는 기타 보기에 채팅을 배치하도록 선택할 수 있습니다. ChatComposite는 스스로 조정하여 사용자에게 원활한 환경을 제공합니다.

내비게이션 보기에서 모달 보기에서
탐색 보기에서 iOS의 채팅 환경을 보여 주는 이미지. iOS의 채팅 환경을 모달 보기로 보여 주는 이미지.

지원되는 ID

복합 요소를 초기화하고 서비스에 인증하려면 사용자에게 Azure Communication Services ID가 있어야 합니다. 자세한 내용은 Azure Communication Services에 인증빠른 시작: 액세스 토큰 만들기 및 관리를 참조하세요.

Azure Communication Services 액세스 토큰을 사용하여 복합 요소를 초기화합니다. 자신이 관리하는 신뢰할 수 있는 서비스를 통해 Azure Communication Services에서 액세스 토큰을 가져오는 것이 중요합니다. 자세한 내용은 빠른 시작: 액세스 토큰 만들기 및 관리신뢰할 수 있는 서비스 자습서를 참조하세요.

UI 라이브러리에 권장되는 아키텍처를 보여 주는 다이어그램

통화 및 채팅 클라이언트 라이브러리에는 참가하는 통화에 대한 컨텍스트가 있어야 합니다. 사용자 액세스 토큰과 마찬가지로, 사용자 고유의 신뢰할 수 있는 서비스를 사용하여 클라이언트에 컨텍스트를 배포합니다. 다음 표에는 클라이언트 라이브러리에 컨텍스트를 추가하는 데 필요한 초기화 및 리소스 관리 기능이 요약되어 있습니다.

Contoso 책임 UI 라이브러리 책임
Azure에서 액세스 토큰 제공 제공된 액세스 토큰을 통과하여 구성 요소 초기화
새로 고침 함수 제공 개발자가 제공한 함수를 사용하여 액세스 토큰 새로 고침
통화 또는 채팅을 위한 참가 정보 검색 및 전달 통화 및 채팅 정보를 전달하여 구성 요소 초기화
사용자 지정 데이터 모델에 대한 사용자 정보 검색 및 전달 렌더링할 구성 요소에 사용자 지정 데이터 모델 전달

플랫폼 지원

플랫폼 버전
iOS iOS 14 이상
Android API 21 이상

문제 해결 가이드

음성 또는 영상 통화에 대한 문제 해결이 발생하면 CallID를 제공하라는 요청을 받을 수 있습니다. 이 ID는 Communication Services 호출을 식별하는 데 사용됩니다.

이 CallID는 통화 화면 하단의 작업 표시줄을 통해 검색할 수 있습니다. 줄임표 단추가 보입니다. 사용자가 탭 작업을 수행하면 "진단 정보 공유" 옵션이 제공됩니다. 사용자는 지원 팀에서 문제를 추적하는 데 필요한 진단 정보를 공유할 수 있습니다.

CallID에 프로그래밍 방식으로 액세스하려면 "프로그래밍 방식으로 디버그 정보를 가져오는 방법"을 참조하세요.

"Azure Communication Services에서 문제 해결" 페이지에서 문제 해결 지침에 대해 자세히 알아볼 수 있습니다.

호출 화면 진단 정보 메뉴 통화 ID 공유
통화 중 통화 화면의 스크린샷. 진단 옵션 위치가 있는 호출 화면의 스크린샷. Contoso와 통화 ID 공유를 보여 주는 스크린샷.