통화 SDK에서 Teams 사용자에게 지원되는 통화 기능

  • 아티클

Azure Communication Services Calling SDK를 사용하면 Teams 사용자 디바이스에서 음성 및 비디오 통신 환경을 구동할 수 있습니다. 이 페이지에서는 플랫폼 및 브라우저 지원 정보를 비롯한 통화 기능에 대해 자세히 설명합니다. JavaScript를 즉시 시작하려면 통화 빠른 시작을 확인하세요.

Calling SDK의 주요 기능:

  • 주소 지정 - Azure Communication Services는 Microsoft Entra 사용자 ID를 사용하여 통신 엔드포인트의 주소를 지정합니다. 클라이언트는 Microsoft Entra ID를 사용하여 서비스에 대해 인증하고 서로 통신합니다. 이러한 ID는 통화에 연결된 사용자를 클라이언트가 볼 수 있도록 하는 통화 API를 호출하는 데 사용됩니다(명단). Microsoft Graph API에서도 사용됩니다.
  • 암호화 - Calling SDK는 트래픽을 암호화하고 네트워크 변조를 방지합니다.
  • 디바이스 관리 및 미디어 - 통화 SDK는 오디오 및 비디오 디바이스에 바인딩하는 기능을 제공하고, 통신 데이터 평면에서의 효율적인 전송을 위해 콘텐츠를 인코딩하며, 지정한 출력 디바이스 및 보기로 콘텐츠를 렌더링합니다. API는 화면 및 애플리케이션 공유에도 제공됩니다.
  • 알림 - 통화 SDK는 클라이언트가 수신 전화를 알릴 수 있는 API를 제공합니다. 앱이 포그라운드에서 실행되지 않는 상황에서, 패턴을 사용하여 사용자에게 수신 전화를 알리기 위해 팝업 알림(“알림”)을 실행할 수 있습니다.

통화 기능

다음 목록은 1:1 VoIP(Voice-over-IP) 또는 그룹 VoIP 통화에 참여할 때 Azure Communication Services Calling SDK에서 현재 사용할 수 있는 기능 집합을 나타냅니다.

기능 그룹 기능 JavaScript Windows Java(Android) Objective-C(iOS)
핵심 기능 Teams 사용자에게 일 대 일 전화 걸기 ✔️ ✔️ ✔️ ✔️
Azure Communication Services 사용자에게 일 대 일 전화 걸기 ❌ ❌ ❌ ❌
2명 이상의 Teams 사용자(최대 350명)와 그룹 통화하기 ✔️ ✔️ ✔️ ✔️
2명의 Teams 사용자와의 일 대 일 통화를 2명 이상의 Teams 사용자와의 그룹 통화로 승격 ✔️ ✔️ ✔️ ✔️
시작된 후 그룹 호출 조인 ❌ ❌ ❌ ❌
진행 중인 그룹 호출에 참가하기 위해 다른 VoIP 참가자 초대 ✔️ ✔️ ✔️ ✔️
오디오 테스트 서비스를 사용하여 마이크, 스피커 및 카메라 테스트(8:echo123을 호출하여 사용 가능) ✔️ ✔️ ✔️ ✔️
전화를 걸면 Teams 외부 액세스 구성이 적용됩니다. ✔️ ✔️ ✔️ ✔️
전화를 걸면 Teams 게스트 액세스 구성이 적용됩니다. ✔️ ✔️ ✔️ ✔️
중간 호출 컨트롤 비디오 켜기/끄기 ✔️ ✔️ ✔️ ✔️
마이크 음소거/음소거 해제 ✔️ ✔️ ✔️ ✔️
카메라 간 전환 ✔️ ✔️ ✔️ ✔️
로컬 보류/유지 취소 ✔️ ✔️ ✔️ ✔️
통화의 주 스피커 표시기 ✔️ ✔️ ✔️ ✔️
통화용 스피커 디바이스 선택 ✔️ ✔️ ❌2 ❌2
통화에 대한 마이크 선택 ✔️ ✔️ ❌2 ❌2
참가자의 상태 표시기
유휴, 초기 미디어, 연결, 연결됨, 보류 중, 로비 내, 연결 끊김		 ✔️ ✔️ ✔️ ✔️
통화 상태 표시기
초기 미디어, 수신, 연결 중, 울림, 연결됨, 보류 중, 연결 끊기, 연결 끊어짐		 ✔️ ✔️ ✔️ ✔️
음소거 중인 참가자 표시 ✔️ ✔️ ✔️ ✔️
참가자의 통화 종료 이유 표시 ✔️ ✔️ ✔️ ✔️
화면 공유 애플리케이션 내에서 전체 화면 공유 ✔️ ✔️1 ✔️1 ✔️1
특정 애플리케이션 공유(실행 중인 애플리케이션 목록에서) ✔️ ✔️1 ❌ ❌
열려 있는 탭 목록에서 웹 브라우저 탭 공유 ✔️ ✔️ ✔️ ✔️
화면 공유 스트림 받기 ❌ ❌ ❌ ❌
"콘텐츠 전용" 모드에서 콘텐츠 공유 ✔️ ✔️ ✔️ ✔️
"콘텐츠 전용" 화면 공유 환경을 위한 콘텐츠가 포함된 동영상 스트림 수신 ✔️ ✔️ ✔️ ✔️
“스탠드아웃” 모드로 콘텐츠 공유 ❌ ❌ ❌ ❌
“스탠드아웃” 화면 공유 환경에 대한 콘텐츠가 포함된 비디오 스트림 받기 ❌ ❌ ❌ ❌
“나란히” 모드에서 콘텐츠 공유 ❌ ❌ ❌ ❌
“나란히” 화면 공유 환경에 대한 콘텐츠가 포함된 비디오 스트림 받기 ❌ ❌ ❌ ❌
“보고자” 모드에서 콘텐츠 공유 ❌ ❌ ❌ ❌
“보고자” 화면 공유 환경에 대한 콘텐츠가 포함된 비디오 스트림 받기 ❌ ❌ ❌ ❌
화면 공유 중 시스템 오디오 공유 ✔️ ❌ ❌ ❌
명단 참가자 리스트 ✔️ ✔️ ✔️ ✔️
Azure Communication Services 사용자 추가 ❌ ❌ ❌ ❌
Teams 사용자 추가 ✔️ ✔️ ✔️ ✔️
Teams 사용자를 추가하면 Teams 외부 액세스 구성이 적용됩니다. ✔️ ✔️ ✔️ ✔️
Teams 사용자 추가 시 Teams 게스트 액세스 구성 적용 ✔️ ✔️ ✔️ ✔️
전화 번호 추가 ✔️ ✔️ ✔️ ✔️
참가자 제거 ✔️ ✔️ ✔️ ✔️
대기실의 참가자를 Teams 모임에 입장하도록 허용 ✔️ ✔️ ✔️ ✔️
대기실에서 Teams 모임에 입장 ✔️ ✔️ ✔️ ✔️
Teams 사용자를 추가하면 정보 장애물이 적용됩니다. ✔️ ✔️ ✔️ ✔️
디바이스 관리 오디오 및/또는 비디오 사용 권한 요청 ✔️ ✔️ ✔️ ✔️
카메라 목록 가져오기 ✔️ ✔️ ✔️ ✔️
카메라 설정 ✔️ ✔️ ✔️ ✔️
선택한 카메라 가져오기 ✔️ ✔️ ✔️ ✔️
마이크 목록 가져오기 ✔️ ✔️ ✔️ ✔️
마이크 설정 ✔️ ✔️ ✔️ ✔️
선택한 마이크 가져오기 ✔️ ✔️ ✔️ ✔️
스피커 목록 가져오기 ✔️ ✔️ ✔️ ✔️
스피커 설정 ✔️ ✔️ ✔️ ✔️
선택한 스피커 가져오기 ✔️ ✔️ ✔️ ✔️
비디오 렌더링 여러 위치에서 단일 비디오 렌더링(로컬 카메라 또는 원격 스트림) ✔️ ✔️ ✔️ ✔️
크기 조정 모드 설정/업데이트 ✔️ ✔️ ✔️ ✔️
원격 비디오 스트림 렌더링 ✔️ ✔️ ✔️ ✔️
함께 모드 비디오 스트림 표시 ✔️ ❌ ❌ ❌
대형 갤러리 보기 표시 ❌ ❌ ❌ ❌
Teams 미디어 봇에서 비디오 스트림 받기 ❌ ❌ ❌ ❌
“카메라의 콘텐츠”에 대해 조정된 스트림 받기 ❌ ❌ ❌ ❌
스포트라이트에서 비디오 스트림 추가 및 제거 ✔️ ✔️ ✔️ ✔️
스포트라이트에 대한 비디오 스트림을 선택하도록 허용 ✔️ ✔️ ✔️ ✔️
비디오 효과 배경색 흐리게 ✔️ ✔️ ✔️ ✔️
사용자 지정 배경 이미지 ✔️ ❌ ❌ ❌
녹음/녹화 및 대화 내용 기록 Teams 클라우드 기록 관리 ❌ ❌ ❌ ❌
녹음/녹화 중인 통화 정보 받기 ✔️ ✔️ ✔️ ✔️
Teams 로컬 기록 관리 ❌ ❌ ❌ ❌
로컬로 녹음/녹화 중인 통화 정보 받기 ✔️ ✔️ ✔️ ✔️
Teams 대화 내용 기록 관리 ❌ ❌ ❌ ❌
대화 내용 기록 중인 통화 정보 받기 ✔️ ✔️ ✔️ ✔️
Teams 선택 자막 관리 ✔️ ✔️ ✔️ ✔️
규정 준수 기록 지원 ✔️ ✔️ ✔️ ✔️
참여 손 올리기 및 내리기 ✔️ ✔️ ✔️ ✔️
다른 참가자의 손 올리기 및 내리기 표시 ✔️ ✔️ ✔️ ✔️
트리거 반응 ❌ ❌ ❌ ❌
다른 참가자의 반응 표시 ❌ ❌ ❌ ❌
통합 Teams 타사 애플리케이션 제어 ❌ ❌ ❌ ❌
PowerPoint 라이브 스트림 받기 ❌ ❌ ❌ ❌
Whiteboard 스트림 수신 ❌ ❌ ❌ ❌
설문 조사와 상호 작용 ❌ ❌ ❌ ❌
Q&A와 상호 작용 ❌ ❌ ❌ ❌
고급 통화 라우팅 통화를 시작하고 사용자 작업을 추가하여 전달 규칙 적용 ✔️ ✔️ ✔️ ✔️
착신 전환 규칙 읽기 및 구성 ❌ ❌ ❌ ❌
통화를 시작하고 사용자 작업을 추가하여 동시 벨 울림 적용 ✔️ ✔️ ✔️ ✔️
동시 울림 읽기 및 구성 ❌ ❌ ❌ ❌
통화를 시작하고 사용자 작업을 추가하여 "방해 금지" 상태 적용 ✔️ ✔️ ✔️ ✔️
참가자가 보류 상태일 때 대기 음악 재생 ✔️ ❌ ❌ ❌
Teams 클라이언트의 Teams 사용자가 보류 중일 때 대기 음악 재생 ✔️ ✔️ ✔️ ✔️
통화 대기 ❌ ❌ ❌ ❌
대기 ✔️ ✔️ ✔️ ✔️
통화를 사용자에게 전달 ✔️ ✔️ ✔️ ✔️
사용자 또는 통화로 전송 ✔️ ✔️ ✔️ ✔️
통화를 통화로 전환 ✔️ ✔️ ✔️ ✔️
통화를 음성 메일로 전환 ✔️ ✔️ ✔️ ✔️
음성 메일로 전송 ✔️ ✔️ ✔️ ✔️
진행 중인 통화 병합 ❌ ❌ ❌ ❌
통화를 시작하고 사용자 작업을 추가할 때 공유 회선 구성 적용 ✔️ ✔️ ✔️ ✔️
Teams 사용자를 대신하여 통화 시작 ❌ ❌ ❌ ❌
공유 회선 구성 읽기 및 구성 ❌ ❌ ❌ ❌
Teams 자동 전화 교환에서 전화 받기 ✔️ ✔️ ✔️ ✔️
Teams 자동 전화 교환으로 통화 전송 ✔️ ✔️ ✔️ ✔️
Teams 통화 큐에서 전화 받기 ✔️ ✔️ ✔️ ✔️
Teams 통화 큐에서 통화 전송 ✔️ ✔️ ✔️ ✔️
Teams 호출 정책 "프라이빗 전화 걸기" 적용 ✔️ ✔️ ✔️ ✔️
"통화용 클라우드 녹음" 설정 적용 사용 가능한 API 없음 사용 가능한 API 없음 사용 가능한 API 없음 사용 가능한 API 없음
“대화 내용 기록” 설정 적용 사용 가능한 API 없음 사용 가능한 API 없음 사용 가능한 API 없음 사용 가능한 API 없음
"조직의 사용자에게 착신 전환 및 동시 연결" 설정 적용 ✔️ ✔️ ✔️ ✔️
"외부 전화번호로 착신 전환 및 동시 연결" 설정 적용 ✔️ ✔️ ✔️ ✔️
"인바운드 통화 라우팅에 음성 메일을 사용할 수 있음" 설정 적용 ✔️ ✔️ ✔️ ✔️
"인바운드 통화는 통화 그룹으로 라우팅될 수 있음" 설정 적용 ✔️ ✔️ ✔️ ✔️
"수신 및 발신 전화 위임" 설정 적용 ✔️ ✔️ ✔️ ✔️
"통화료 바이패스 방지 및 PSTN을 통해 전화 보내기" 설정 적용 ❌ ❌ ❌ ❌
"대기 음악" 설정 적용 ❌ ❌ ❌ ❌
"통화 중일 때 통화 중 표시" 설정 적용 ❌ ❌ ❌ ❌
"Teams 통화의 실시간 캡션" 설정 적용 사용 가능한 API 없음 사용 가능한 API 없음 사용 가능한 API 없음 사용 가능한 API 없음
"스팸 필터링" 설정 적용 ✔️ ✔️ ✔️ ✔️
"SIP 디바이스를 통화에 사용할 수 있음" 설정 적용 ✔️ ✔️ ✔️ ✔️
DevOps Azure 메트릭 ✔️ ✔️ ✔️ ✔️
Azure Monitor ✔️ ✔️ ✔️ ✔️
Azure Communication Services 인사이트 ✔️ ✔️ ✔️ ✔️
Azure Communication Services 음성 및 영상 통화 이벤트 ❌ ❌ ❌ ❌
Teams 통화 분석 ✔️ ✔️ ✔️ ✔️
Teams 실시간 분석 ❌ ❌ ❌ ❌
  1. 화면 공유 기능은 Raw Media를 사용하여 달성할 수 있습니다. 원시 미디어를 추가하는 방법을 알아보려면 빠른 시작 가이드를 방문하세요.
  2. Calling SDK에는 명시적 API가 없으므로 이를 달성하려면 OS(android 및 iOS) API를 사용해야 합니다.

스트리밍, 시간 제한, 플랫폼 및 브라우저에 대한 지원은 Communication Services 통화 SDK 개요와 공유됩니다.

다음 단계

전화 시작

자세한 내용은 다음 문서를 참조하세요.