통화 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 실시간 분석 | ❌ | ❌ | ❌ | ❌ |
- 화면 공유 기능은 Raw Media를 사용하여 달성할 수 있습니다. 원시 미디어를 추가하는 방법을 알아보려면 빠른 시작 가이드를 방문하세요.
- Calling SDK에는 명시적 API가 없으므로 이를 달성하려면 OS(android 및 iOS) API를 사용해야 합니다.
스트리밍, 시간 제한, 플랫폼 및 브라우저에 대한 지원은 Communication Services 통화 SDK 개요와 공유됩니다.
다음 단계
자세한 내용은 다음 문서를 참조하세요.