加入 Teams 會議

發行項
10/23/2024

Azure 通訊服務 SDK 可讓您的使用者加入一般 Microsoft Teams 會議。方法如下！

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
已部署通訊服務資源。建立通訊服務資源。
用來啟用呼叫用戶端的使用者存取權杖。如需詳細資訊，請參閱建立和管理存取權杖。
選擇性：完成快速入門以將語音通話新增至您的應用程式

安裝 SDK

使用 npm install 命令，安裝適用於 JavaScript 的 Azure 通訊服務通用和通話 SDK：

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

初始化必要的物件

大部分通話作業都需要 CallClient 執行個體。當您建立新的 CallClient 執行個體時，您可以使用自訂選項加以設定，如同 Logger 執行個體一樣。

使用 CallClient 執行個體，您可以藉由呼叫 createCallAgent 來建立 CallAgent 執行個體。此方法會以非同步的方式傳回 CallAgent 執行個體物件。

createCallAgent 方法會使用 CommunicationTokenCredential 作為引數。其接受使用者存取權杖。

您可以使用 CallClient 執行個體上的 getDeviceManager 方法來存取 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 有兩種可能的狀態：

已連線 - Connected 的 Call Agent connectionStatue 值表示用戶端 SDK 已連線且能夠接收來自 Microsoft 基礎結構的通知。

已中斷連線 - Disconnected 狀態的 Call Agent connectionStatue 值指出有問題導致 SDK 無法正確連線。 Call Agent 應該重新建立。

invalidToken：如果權杖已過期或無效，Call Agent 執行個體會中斷連線，並出現此錯誤。
connectionIssue：如果用戶端連線到 Microsoft 基礎結構時發生問題，在多次重試之後，Call Agent 會公開 connectionIssue 錯誤。

您可以藉由檢查 connectionState 屬性的目前值，檢查本機 Call Agent 是否已連線到 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);

會議聯結方法

若要加入 Teams 會議，請使用 join 方法並傳送會議連結或會議的座標。

使用會議連結加入：

const locator = { meetingLink: '<MEETING_LINK>'}
const call = callAgent.join(locator);

使用會議座標加入 (目前為受限預覽版)：

const locator = {
    threadId: <thread id>,
    organizerId: <organizer id>,
    tenantId: <tenant id>,
    messageId: <message id>
}
const call = callAgent.join(locator);

設定系統

請遵循下列步驟來設定系統。

建立 Visual Studio 專案

針對通用 Windows 平台應用程式，請在 Visual Studio 2022 中建立新的空白應用程式（通用 Windows） 專案。在輸入專案名稱之後，隨意選擇高於 10.0.17763.0 的任何 Windows SDK。

針對 WinUI 3 應用程式，使用空白應用程式、封裝 (桌面中的 WinUI 3) 範本建立新專案，以設定單頁 WinUI 3 應用程式。需要 Windows App SDK 1.3 版或更新版本。

使用 NuGet 套件管理員來安裝套件和相依性

通話 SDK API 和程式庫可透過 NuGet 套件公開取得。

若要尋找、下載並安裝呼叫 SDK NuGet 套件：

藉由選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件]，開啟 NuGet 套件管理員。
選取 [ 瀏覽]，然後在搜尋方塊中輸入 Azure.Communication.Calling.WindowsClient 。
請確定 已選取 [包含發行前版本 ] 複選框。
選取 Azure.Communication.Calling.WindowsClient 套件，然後選取 [Azure.Communication.Calling.WindowsClient 1.4.0-beta.1] 或更新版本。
選取對應至右窗格中 Azure 通訊服務項目的複選框。
選取 [安裝]。

會議聯結方法

若要加入 Teams 會議，請使用 CallAgent.join 方法並傳遞應用程式內容、 JoinMeetingLocator和 JoinCallOptions。

會議標識碼和密碼

TeamsMeetingIdLocator 會使用會議 ID 和密碼來尋找會議。這些可以在 Teams 會議加入資訊下找到。 Teams 會議標識碼會長 12 個字元，且會包含以三個數位分組的數位（亦即 000 000 000 000）。密碼將包含6個字元（亦即 aBcDeF）。密碼區分大小寫。

String meetingId, passcode; 
TeamsMeetingIdLocator locator = new TeamsMeetingIdLocator(meetingId, passcode);

會議連結

會 TeamsMeetingLinkLocator 使用Teams會議的連結來尋找會議。這可以在Teams會議的加入資訊下找到。

String meetingLink; 
TeamsMeetingLinkLocator locator = new TeamsMeetingLinkLocator(meetingLink);

會議座標

會 TeamsMeetingCoordinatesLocator 使用召集人標識碼、租使用者標識碼、線程標識碼和訊息標識碼來尋找會議。您可以使用 Microsoft Graph 找到此資訊。

Guid organizerId, tenantId;
String threadId, messageId;
TeamsMeetingCoordinatesLocator locator = new TeamsMeetingCoordinatesLocator(threadId, organizerId, tenantId, messageId);

使用定位器加入會議

建立這些 Teams 會議定位器之後，您可以使用它來加入 Teams 會議 CallAgent.join ，如下所示。

JoinCallOptions options = new JoinCallOptions();
call = agent.join(
        getApplicationContext(),
        locator,
        options);

設定系統

請遵循下列步驟來設定系統。

建立 Visual Studio 專案

使用 NuGet 套件管理員來安裝套件和相依性

通話 SDK API 和程式庫可透過 NuGet 套件公開取得。

若要尋找、下載並安裝呼叫 SDK NuGet 套件：

藉由選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件]，開啟 NuGet 套件管理員。
選取 [ 瀏覽]，然後在搜尋方塊中輸入 Azure.Communication.Calling.WindowsClient 。
請確定 已選取 [包含發行前版本 ] 複選框。
選取 Azure.Communication.Calling.WindowsClient 套件，然後選取 [Azure.Communication.Calling.WindowsClient 1.4.0-beta.1] 或更新版本。
選取對應至右窗格中 Azure 通訊服務項目的複選框。
選取 [安裝]。

會議聯結方法

若要加入 Teams 會議，請使用 CallAgent.join 方法並傳遞 JoinMeetingLocator 和 JoinCallOptions。

會議標識碼和密碼

String meetingId, passcode
let locator = TeamsMeetingIdLocator(meetingId: meetingId, passcode: passcode)

會議連結

會 TeamsMeetingLinkLocator 使用Teams會議的連結來尋找會議。這可以在Teams會議的加入資訊下找到。

String meetingLink
let locator = TeamsMeetingLinkLocator(meetingLink: meetingLink)

使用定位器加入會議

建立這些 Teams 會議定位器之後，您可以使用它來加入 Teams 會議 CallAgent.join ，如下所示。

func joinTeamsMeeting() {
    // Ask permissions
    AVAudioSession.sharedInstance().requestRecordPermission { (granted) in
        if granted {
            let joinCallOptions = JoinCallOptions()
            
            // Insert meeting locator code for specific join methods here

            // for CallAgent callAgent
            self.callAgent?.join(with: teamsMeetingLinkLocator, joinCallOptions: joinCallOptions) 
        }
    }
}

設定系統

請遵循下列步驟來設定系統。

建立 Visual Studio 專案

使用 NuGet 套件管理員來安裝套件和相依性

通話 SDK API 和程式庫可透過 NuGet 套件公開取得。

若要尋找、下載並安裝呼叫 SDK NuGet 套件：

藉由選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件]，開啟 NuGet 套件管理員。
選取 [ 瀏覽]，然後在搜尋方塊中輸入 Azure.Communication.Calling.WindowsClient 。
請確定 已選取 [包含發行前版本 ] 複選框。
選取 Azure.Communication.Calling.WindowsClient 套件，然後選取 [Azure.Communication.Calling.WindowsClient 1.4.0-beta.1] 或更新版本。
選取對應至右窗格中 Azure 通訊服務項目的複選框。
選取 [安裝]。

會議聯結方法

若要加入 Teams 會議，請使用 CallAgent.JoinAsync 方法並傳遞 JoinMeetingLocator 和 JoinCallOptions。

會議標識碼和密碼

string meetingId, passcode; 
TeamsMeetingIdLocator locator = new TeamsMeetingIdLocator(meetingId, passcode);

會議連結

會 TeamsMeetingLinkLocator 使用Teams會議的連結來尋找會議。這可以在Teams會議的加入資訊下找到。

string meetingLink; 
TeamsMeetingLinkLocator locator = new TeamsMeetingLinkLocator(meetingLink);

會議座標

會 TeamsMeetingCoordinatesLocator 使用召集人標識碼、租使用者標識碼、線程標識碼和訊息標識碼來尋找會議。您可以使用 Microsoft Graph 找到此資訊。

Guid organizerId, tenantId;
string threadId, messageId;
TeamsMeetingCoordinatesLocator locator = new TeamsMeetingCoordinatesLocator(threadId, organizerId, tenantId, messageId);

使用定位器加入會議

建立這些 Teams 會議定位器之後，您可以使用它來加入 Teams 會議 CallAgent.JoinAsync ，如下所示。

var joinCallOptions = new JoinCallOptions() {
        OutgoingAudioOptions = new OutgoingAudioOptions() { IsMuted = true },
        OutgoingVideoOptions = new OutgoingVideoOptions() { Streams = new OutgoingVideoStream[] { cameraStream } }
    };
var call = await callAgent.JoinAsync(locator, joinCallOptions);

共用方式為

加入 Teams 會議

必要條件

安裝 SDK

初始化必要的物件

如何最好地管理與 Microsoft 基礎結構的 SDK 連線

會議聯結方法

設定系統

建立 Visual Studio 專案

使用 NuGet 套件管理員來安裝套件和相依性

會議聯結方法

會議標識碼和密碼

會議連結

會議座標

使用定位器加入會議

設定系統

建立 Visual Studio 專案

使用 NuGet 套件管理員來安裝套件和相依性

會議聯結方法

會議標識碼和密碼

會議連結

使用定位器加入會議

設定系統

建立 Visual Studio 專案

使用 NuGet 套件管理員來安裝套件和相依性

會議聯結方法

會議標識碼和密碼

會議連結

會議座標

使用定位器加入會議

下一步

意見反應

其他資源