대화방 개요

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

대화방이 유용한 주요 시나리오는 다음과 같습니다.

• 대화방을 통해 예약된 통신 환경을 사용할 수 있습니다. 대화방은 서비스 플랫폼이 다양한 산업 애플리케이션에 적합하면서도 모임 스타일의 환경을 제공하는 데 도움이 됩니다. 서비스는 의료 자문을 구하는 환자, 고객과 협력하는 재무 설계사 및 법률 서비스를 제공하는 변호사를 위해 대화방을 예약하고 관리할 수 있습니다.
• 대화방을 통해 초대 전용 환경을 사용할 수 있습니다. 대화방을 사용하면 서비스에서 의사 또는 재무 상담사와의 가상 약속을 위해 대화방에 참가할 수 있는 사용자를 제어할 수 있습니다. 이렇게 하면 Communication Services ID가 할당된 사용자의 하위 집합만 회의실 통화에 참가할 수 있습니다.
• 대화방에서 역할과 권한을 통해 구조화된 통신을 수행할 수 있습니다. 대화방을 사용하면 개발자가 미리 정의된 역할을 사용자에게 할당하여 통신에서 더 높은 수준의 제어 및 구조를 활용할 수 있습니다. 발표자만 대규모 모임 또는 가상 회의에서 콘텐츠를 말하고 공유할 수 있도록 합니다.
• PSTN 참가자를 추가합니다. 구독을 통해 구매한 번호를 사용하거나 Azure를 통해 SBC(Session Border Controller)로 직접 라우팅하여 PSTN(공중 교환 전화망) 참가자를 통화에 초대합니다.

대화방을 사용하는 경우

다음 기능이 필요한 경우 대화방을 사용합니다.

• 대화방 통화에 참가할 수 있는 사용자를 제어합니다.
• 사용하도록 설정되고 지정된 시간과 날짜에 만료되는 일정/좌표가 필요합니다.
• 사용자에 대한 역할 및 권한을 통해 구조화된 통신이 필요합니다.

기능	1:N 통화	1:N 통화 (임시 ID 사용)	대화방 통화
대화형 참가자	350	350	350
참가자에게 배포할 임시 ID	❌	✔️ (그룹 ID)	✔️ (대화방 ID)
초대 대상자만 참가	❌	❌	✔️
PSTN 사용자에게 전화 걸기 기능	✔️	✔️	✔️
통화 캡션	✔️ 프라이빗 미리 보기	✔️ 프라이빗 미리 보기	✔️ 프라이빗 미리 보기
통화 녹화	✔️	✔️	✔️ 공개 미리 보기
통화에 참가하기 위한 통신 서비스 리소스의 모든 사용자	❌	✔️	✔️
통화 유효 기간 설정	❌	❌	✔️ 최대 6개월
통화에 대한 사용자 역할 및 권한 설정	❌	❌	✔️
통화를 만들고, 제거하고, 업데이트하고, 삭제하는 API	❌	❌	✔️ 대화방 API

대화방 관리 및 대화방 통화 참가

대화방 API/SDK는 대화방 만들기, 참가자 추가, 일정 설정 등과 같은 작업을 수행하는 데 사용됩니다. 통화 SDK는 클라이언트 쪽에서 대화방 내에서 통화를 시작하는 데 사용됩니다. 통화 SDK의 일대일 또는 그룹 통화에서 사용할 수 있는 대부분의 작업은 대화방 통화에서도 사용할 수 있습니다. 통화 SDK에서 제공되는 기능의 전체 목록은 통화 SDK 개요에 나와 있습니다.

기능	통화 SDK	대화방 API/SDK
음성 및 비디오로 대화방 통화에 참가	✔️	❌
대화방 통화에 참가한 참가자 나열	✔️	❌
가상 회의실 수준에서 PSTN 사용자에 대한 전화 걸기 허용/허용 안 함	❌	✔️
대화방 만들기	❌	✔️
대화방에 초대된 모든 참가자 나열	❌	✔️
VoIP 참가자 추가 또는 제거	❌	✔️
대화방 참가자에게 역할 할당	❌	✔️

아래 그림에서는 대화방 관리 및 참가에 대한 개념을 보여 줍니다.

Virtual Rooms API/SDK

대화방은 대화방 API 또는 SDK를 통해 만들어지고 관리됩니다. room 작업을 위해 서버 애플리케이션에서 대화방 API/SDK를 사용합니다.

• 만들기
• 수정
• 삭제
• 참가자 목록 설정 및 업데이트
• 대화방 유효성 설정 및 수정
• 사용자에게 역할 및 권한을 할당합니다. 세부 정보는 아래를 참조하세요.

Virtual Rooms SDK	버전	State(상태)
Virtual Rooms SDK	2024-04-15	일반 공급 - 완전 지원
Virtual Rooms SDK	2023-10-30	공개 미리 보기 - 완전히 지원됨
Virtual Rooms SDK	2023-06-14	일반 공급 - 완전 지원
Virtual Rooms SDK	2023-03-31	2024년 4월 30일에 사용 중지됨
Virtual Rooms SDK	2022-02-01	2024년 4월 30일에 사용 중지됨
Virtual Rooms SDK	2021-04-07	2024년 4월 30일에 사용 중지됨

통화 SDK

통화 SDK를 사용하여 대화방 통화에 참가합니다. 대화방 통화는 웹, iOS 또는 Android 통화 SDK를 사용하여 참가할 수 있습니다. 대화방 통화에 참가하기 위한 빠른 시작 샘플은 여기서 찾을 수 있습니다.

또한 대화방은 Azure Communication Services UI 라이브러리를 사용하여 액세스할 수 있습니다. UI 라이브러리를 사용하면 개발자가 몇 줄의 코드만 사용하여 대화방이 사용하도록 설정된 통화 클라이언트를 애플리케이션에 추가할 수 있습니다.

미리 정의된 참가자 역할 및 권한

대화방 참가자는 발표자, 참석자 및 소비자 역할 중 하나를 할당받을 수 있습니다. 다른 역할이 할당되지 않은 경우 기본적으로참석자 역할이 사용자에게 할당됩니다.

아래 표에는 역할에 매핑된 자세한 기능이 나와 있습니다. 개략적으로 발표자 역할은 모든 권한을 가지며, 참석자 기능은 오디오 및 비디오로 제한되고, 소비자는 오디오, 비디오 및 화면 받을 수신할 수 있습니다.

기능	역할: 발표자	역할: 참석자	역할: 소비자
중간 통화 제어
- 비디오 켜기/끄기	✔️	✔️	❌
- 마이크 음소거/음소거 해제	✔️	✔️	❌
- 원격 사용자 음소거 **	✔️	❌	❌
- 카메라 간 전환	✔️	✔️	❌
- 활성 스피커	✔️	✔️	✔️
- 통화용 스피커 선택	✔️	✔️	✔️
- 통화용 마이크 선택	✔️	✔️	❌
- 참가자 상태 표시(유휴, 연결 중, 연결됨, 보류 중, 연결 끊는 중, 연결 끊김 등)	✔️	✔️	✔️
- 통화 상태 표시(초기 미디어, 수신 중, 연결 중, 전화 거는 중, 연결됨, 대기, 연결 끊는 중, 연결 끊김)	✔️	✔️	✔️
- 참가자가 음소거되어 있는지 여부 표시	✔️	✔️	✔️
- 참가자가 전화를 끊은 이유 표시	✔️	✔️	✔️
화면 공유
- 화면 공유	✔️ *	❌	❌
- 애플리케이션 공유	✔️ *	❌	❌
- 브라우저 탭 공유	✔️ *	❌	❌
- 참가자가 공유 화면을 볼 수 있음	✔️	✔️	✔️
명단 관리
- 참가자 제거	✔️	❌	❌
디바이스 관리
- 오디오 및/또는 비디오 사용 권한 요청	✔️	✔️	❌
- 카메라 목록 가져오기	✔️	✔️	❌
- 카메라 설정	✔️	✔️	❌
- 선택한 카메라 가져오기	✔️	✔️	❌
- 마이크 목록 가져오기	✔️ *	✔️ *	❌
- 마이크 설정	✔️ *	✔️ *	❌
- 선택한 마이크 가져오기	✔️ *	✔️ *	❌
- 발표자 목록 가져오기	✔️ *	✔️ *	✔️ *
- 스피커 설정	✔️ *	✔️ *	✔️ *
- 선택한 스피커 가져오기	✔️	✔️	✔️
비디오 렌더링
- 여러 위치에서 비디오 렌더링(로컬 카메라 또는 원격 스트림)	✔️	✔️	✔️ (원격만 해당)
- 비디오 크기 조정 모드 설정/업데이트	✔️	✔️	✔️ (원격만 해당)
- 원격 비디오 스트림 렌더링	✔️	✔️	✔️
PSTN 참가자 추가
- 전화 통화를 사용하여 참가자에게 전화 걸기	✔️	❌	❌

* 웹 통화 SDK에서만 사용할 수 있습니다. iOS 및 Android 통화 SDK에서는 사용할 수 없습니다.

** 현재 공개 미리 보기로 제공됩니다.

이벤트 처리

Event Grid를 통해 게시된 음성 및 영상 통화 이벤트에는 대화방 통화 정보가 주석으로 추가됩니다.

• CallStarted는 대화방 통화를 시작할 때 게시됩니다.
• CallEnded는 대화방 통화를 종료할 때 게시됩니다.
• CallParticipantAdded는 새 참가자가 대화방 통화에 참가할 때 게시됩니다.
• CallParticipantRemoved는 참가자가 대화방 통화에서 나갈 때 게시됩니다.

사용되지 않는 기능

이전 공개 미리 보기 버전의 Rooms API는 다음과 같이 회의실 명단 제어에 대한 두 가지 구성을 지원했습니다.

• 초대된 사용자만 회의실 통화에 참가할 수 있는 "초대 전용" 회의실입니다.
• 덜 안전한 "오픈 회의실"입니다. 오픈 회의실 구성에서 모든 Azure Communication Services 사용자는 회의실 명단을 통해 명시적으로 초대되지 않고 통화에 참가할 수 있었습니다.

"오픈 회의실" 개념은 이제 더 이상 사용되지 않습니다. 앞으로는 "초대 전용" 회의실이 유일하게 지원되는 회의실 유형이 됩니다.

알려진 제한 사항

• Azure Communication Services 통화 자동화 기능은 현재 회의실 통화를 지원하지 않습니다.

다음 단계:

• 빠른 시작을 사용하여 대화방을 만들고 관리하고 참가합니다.
• 대화방 통화에 참가하는 방법을 알아봅니다.
• 미디어 및 신호에 대한 네트워크 요구 사항을 검토합니다.
• 회의실 데이터를 분석합니다. 회의실 로그를 참조하세요.
• Log Analytics 작업 영역을 사용하는 방법에 대한 자세한 내용은 Log Analytics 자습서를 참조하세요.
• Log Analytics에서 사용자 고유의 쿼리를 만듭니다. 쿼리 시작을 참조하세요.