Microsoft Teams 모임 오디오 회의

이 문서에서는 Azure Communication Services 통화 SDK를 사용하여 Microsoft Teams 모임 오디오 회의 세부 정보를 검색하는 방법을 설명합니다. 이 기능을 사용하면 Microsoft Teams 모임에 이미 연결된 사용자가 모임과 연결된 전화 접속 전화 번호 및 회의 ID를 가져올 수 있습니다. Teams 모임 오디오 회의 기능은 모든 통행료 및 무료 번호의 컬렉션을 반환합니다. 컬렉션에는 수반되는 국가/지역 이름 및 도시 이름이 포함되어 있어 사용자가 사용할 Teams 모임 전화 접속 세부 정보를 제어할 수 있습니다.

필수 조건

• 활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
• 배포된 Communication Services 리소스. Communication Services 리소스 만들기
• 호출 클라이언트를 사용하도록 설정하는 사용자 액세스 토큰입니다. 자세한 정보. 액세스 토큰을 만들고 관리합니다.
• 선택 사항: 빠른 시작을 완료하여 애플리케이션에 음성 통화를 추가합니다.

지원

이 섹션에서는 Azure Communication Services의 오디오 회의 대한 지원을 설명합니다.

ID 및 호출 형식

다음 표에서는 호출 및 ID 형식에 대한 지원을 보여줍니다.

정체성	Teams 모임	방	1:1 통화	그룹 통화	1:1 Teams Interop 통화	그룹 Teams Interop 통화
Communication Services 사용자	✔️
Microsoft 365 사용자	✔️

작업

다음 표에서는 개별 ID 형식에 대해 SDK를 호출하는 개별 API에 대한 지원을 보여 줍니다.

작업	Communication Services 사용자	Microsoft 365 사용자
오디오 회의 세부 정보 가져오기	✔️	✔️

SDK

다음 표에서는 개별 Azure Communication Services SDK의 오디오 회의 기능에 대한 지원을 보여 줍니다.

플랫폼	웹	웹 UI	아이폰 OS	iOS 사용자 인터페이스 (UI)	안드로이드	안드로이드 사용자 인터페이스	윈도우즈
지원됨	✔️

SDK 설치

npm install 명령을 사용하여 다음과 같은 JavaScript용 Azure Communication Services Common 및 통화 SDK를 설치합니다.

npm install @azure/communication-common --save
npm install @azure/communication-calling --save

필수 개체 초기화

대부분의 호출 작업에는 CallClient 인스턴스가 필요합니다. 새 CallClient 인스턴스를 만들 때 Logger 인스턴스와 같은 사용자 지정 옵션을 사용하여 이 새 인스턴스를 구성할 수 있습니다.

CallClient 인스턴스를 사용하면 CallAgent를 호출하여 createCallAgent 인스턴스를 만들 수 있습니다. 이 메서드는 CallAgent 인스턴스 개체를 비동기적으로 반환됩니다.

createCallAgent 메서드는 CommunicationTokenCredential을 인수로 사용합니다. 사용자 액세스 토큰이 허용됩니다.

getDeviceManager 인스턴스에서 CallClient 메서드를 사용하여 deviceManager에 액세스할 수 있습니다.

const { CallClient } = require('@azure/communication-calling');
const { AzureCommunicationTokenCredential} = require('@azure/communication-common');
const { AzureLogger, setLogLevel } = require("@azure/logger");

// Set the logger's log level
setLogLevel('verbose');

// Redirect log output to console, file, buffer, REST API, or whatever location you want
AzureLogger.log = (...args) => {
    console.log(...args); // Redirect log output to console
};

const userToken = '<USER_TOKEN>';
callClient = new CallClient(options);
const tokenCredential = new AzureCommunicationTokenCredential(userToken);
const callAgent = await callClient.createCallAgent(tokenCredential, {displayName: 'optional Azure Communication Services user name'});
const deviceManager = await callClient.getDeviceManager()

Microsoft 인프라에 대한 SDK 연결 관리

Call Agent 인스턴스는 통화를 관리하는 데 도움이 됩니다(통화 참여 또는 시작). 작동하려면 통화 SDK가 Microsoft 인프라에 연결하여 수신 전화에 대한 알림을 가져오고 기타 호출 세부 정보를 조정해야 합니다. 사용자의 Call Agent에는 두 가지 상태가 있을 수 있습니다.

연결됨 - Call Agent connectionStatue 값이 Connected이면 클라이언트 SDK가 연결되어 있고 Microsoft 인프라로부터 알림을 받을 수 있음을 의미합니다.

연결 끊김 - Call Agent의 Disconnected connectionStatue 값은 SDK가 제대로 연결되지 못하게 하는 문제가 있음을 나타냅니다. Call Agent를 다시 만들어야 합니다.

• invalidToken: 토큰이 만료되었거나 유효하지 않은 경우 Call Agent 인스턴스가 이 오류와 함께 연결 끊기됩니다.
• connectionIssue: 클라이언트가 Microsoft 인프라에 연결하는 데 문제가 있는 경우 여러 번 다시 시도한 후 Call Agent가 connectionIssue 오류를 노출합니다.

Call Agent 속성의 현재 값을 검사하여 로컬 connectionState가 Microsoft 인프라에 연결되어 있는지 확인할 수 있습니다. 활성 통화 중에 connectionStateChanged 이벤트를 수신 대기하여 Call Agent가 연결됨에서 연결 끊김 상태로 변경되는지 확인할 수 있습니다.

const connectionState = callAgentInstance.connectionState;
console.log(connectionState); // it may return either of 'Connected' | 'Disconnected'

const connectionStateCallback = (args) => {
    console.log(args); // it will return an object with oldState and newState, each of having a value of either of 'Connected' | 'Disconnected'
    // it will also return reason, either of 'invalidToken' | 'connectionIssue'
}
callAgentInstance.on('connectionStateChanged', connectionStateCallback);

Microsoft Teams 모임 오디오 회의 핵심 Call API의 확장된 기능입니다. 먼저 통화 SDK에서 호출 기능을 가져와야 합니다.

import { Features} from "@azure/communication-calling";

그런 다음 호출 인스턴스에서 기능 API 개체를 가져올 수 있습니다.

const audioConferencingFeature = call.feature(Features.TeamsMeetingAudioConferencing);

모임의 오디오 회의 세부 정보 가져오기

다음 API를 사용하여 모임의 오디오 회의 세부 정보 가져오기

try {
     const details: SDK.TeamsMeetingAudioConferencingDetails = audioConferencingFeature.getTeamsMeetingAudioConferencingDetails();
     console.log(`Microsoft Teams Meeting Conference Id: ${details.phoneConferenceId}`);
     details.phoneNumbers.forEach(dialInPhoneNumber => {
        if (dialInPhoneNumber.tollPhoneNumber) { 
            console.log(`Dial-In Toll PhoneNumber: ${dialInPhoneNumber.tollPhoneNumber.phoneNumber}`);
        }
        else if (dialInPhoneNumber.tollFreePhoneNumber) { 
            console.log(`Dial-In TollFree PhoneNumber: ${dialInPhoneNumber.tollFreePhoneNumber.phoneNumber}`);
        } 
        else if (dialInPhoneNumber.countryName) {
            console.log(`Dial-In Country Name: ${dialInPhoneNumber.countryName}`);
        }
        else if (dialInPhoneNumber.cityName) {
            console.log(`Dial-In City Name: ${dialInPhoneNumber.cityName}`);
        }
    })
} catch (e) {
    console.error(e);
}

문제 해결

코드	하위 코드	결과 범주	원인	해결
400	45950	예상된 오류	오디오 회의 기능은 Teams 모임에서만 사용할 수 있습니다.	구성된 오디오 회의를 사용하여 Teams 모임 참가
405	45951	예상된 오류	ACS 서비스 사용 안 함 오디오 회의	지원을 요청하는 Azure 지원 티켓 만들기
403	45952	예상된 오류	모임에 참가하기 전에는 오디오 회의 세부 정보를 사용할 수 없습니다.	오디오 회의 세부 정보를 검색하기 위해 API를 호출하기 전에 호출 개체 connected 가 상태에 있는지 확인합니다.
403	45953	예상된 오류	로비에서는 오디오 회의 세부 정보를 사용할 수 없습니다.	오디오 회의 세부 정보를 검색하기 위해 API를 호출하기 전에 호출 개체 connected 가 상태에 있는지 확인합니다.

다음 단계

• 통화 관리 방법 알아보기
• 동영상 관리 방법 알아보기
• 통화를 기록하는 방법 알아보기
• 통화 내용 기록 방법 알아보기