Подключение к собранию Teams - An Azure Communication Services how-to guide

Установка пакета SDK

npm install Используйте команду для установки пакета SDK Службы коммуникации Azure Common and Calling SDK для JavaScript:

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()

Управление подключением пакета SDK к инфраструктуре Майкрософт

Экземпляр Call Agent помогает управлять вызовами (для присоединения или запуска вызовов). Для работы пакета SDK для вызова необходимо подключиться к инфраструктуре Майкрософт для получения уведомлений о входящих звонках и координации других сведений о вызове. У вас Call Agent есть два возможных состояния:

Подключено — Call Agent значение Connected connectionStatue означает, что клиентский пакет SDK подключен и способен получать уведомления из инфраструктуры Майкрософт.

Отключено — Call Agent значение connectionStatue состояний Disconnected возникает проблема, которая препятствует правильному подключению пакета SDK. Call Agent необходимо повторно создать.

invalidToken: если срок действия маркера истек или является недопустимым Call Agent экземпляром, отключается с этой ошибкой.
connectionIssue: если возникла проблема с клиентом, подключающимся к инфраструктуре Майкрософт, после многих повторных попыток Call Agent возникает connectionIssue ошибка.

Вы можете проверить, подключен ли локальный сервер Call Agent к инфраструктуре Майкрософт, проверив текущее значение connectionState свойства. Во время активного вызова можно прослушивать 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). После ввода имени проекта вы можете выбрать любой пакет SDK для Windows позже 10.0.17763.0.

Для приложения WinUI 3 создайте проект с шаблоном "Пустое приложение" (WinUI 3 в классическом приложении) для настройки одностраничного приложения WinUI 3. Требуется пакет SDK для приложений Windows версии 1.3 или более поздней.

Установка пакета и зависимостей с помощью NuGet диспетчер пакетов

Api и библиотеки пакета SDK для вызовов общедоступны через пакет NuGet.

Чтобы найти, скачать и установить пакет NuGet пакета Sdk для вызовов:

Откройте nuGet диспетчер пакетов, выбрав инструменты>NuGet диспетчер пакетов> Manage NuGet Packages for Solution.
Выберите "Обзор" и введите Azure.Communication.Calling.WindowsClient в поле поиска.
Убедитесь, что установлен флажок "Включить предварительную версию ".
Выберите пакет Azure.Communication.Calling.WindowsClient, а затем выберите Azure.Communication.Calling.WindowsClient 1.4.0-beta.1 или более позднюю версию.
Установите флажок, соответствующий проекту Службы коммуникации Azure на правой панели.
Выберите Установить.

Методы присоединения к собранию

Чтобы присоединиться к собранию CallAgent.join Teams, используйте метод и передайте контекст приложения, JoinMeetingLocatorа также JoinCallOptions.

Идентификатор собрания и секретный код

Он TeamsMeetingIdLocator находит собрание с помощью идентификатора собрания и секретного кода. Их можно найти в разделе сведений о присоединении к собранию 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

Для приложения универсальная платформа Windows в Visual Studio 2022 создайте проект пустого приложения (универсального приложения Windows). После ввода имени проекта вы можете выбрать любой пакет SDK для Windows позже 10.0.17763.0.

Для приложения WinUI 3 создайте проект с шаблоном "Пустое приложение" (WinUI 3 в классическом приложении) для настройки одностраничного приложения WinUI 3. Требуется пакет SDK для приложений Windows версии 1.3 или более поздней.

Установка пакета и зависимостей с помощью NuGet диспетчер пакетов

Api и библиотеки пакета SDK для вызовов общедоступны через пакет NuGet.

Чтобы найти, скачать и установить пакет NuGet пакета Sdk для вызовов:

Откройте nuGet диспетчер пакетов, выбрав инструменты>NuGet диспетчер пакетов> Manage NuGet Packages for Solution.
Выберите "Обзор" и введите Azure.Communication.Calling.WindowsClient в поле поиска.
Убедитесь, что установлен флажок "Включить предварительную версию ".
Выберите пакет Azure.Communication.Calling.WindowsClient, а затем выберите Azure.Communication.Calling.WindowsClient 1.4.0-beta.1 или более позднюю версию.
Установите флажок, соответствующий проекту Службы коммуникации Azure на правой панели.
Выберите Установить.

Методы присоединения к собранию

Чтобы присоединиться к собранию CallAgent.join Teams, используйте метод и передайте его JoinMeetingLocator JoinCallOptions.

Идентификатор собрания и секретный код

Он TeamsMeetingIdLocator находит собрание с помощью идентификатора собрания и секретного кода. Их можно найти в разделе сведений о присоединении к собранию Teams. Идентификатор собрания Teams будет длиннее 12 символов и будет состоять из числовых цифр, сгруппированных в три (т. е. 000 000 000 000). Секретный код будет состоять из 6 символов алфавита (т. е. aBcDeF). Секретный код учитывает регистр.

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

Для приложения универсальная платформа Windows в Visual Studio 2022 создайте проект пустого приложения (универсального приложения Windows). После ввода имени проекта вы можете выбрать любой пакет SDK для Windows позже 10.0.17763.0.

Для приложения WinUI 3 создайте проект с шаблоном "Пустое приложение" (WinUI 3 в классическом приложении) для настройки одностраничного приложения WinUI 3. Требуется пакет SDK для приложений Windows версии 1.3 или более поздней.

Установка пакета и зависимостей с помощью NuGet диспетчер пакетов

Api и библиотеки пакета SDK для вызовов общедоступны через пакет NuGet.

Чтобы найти, скачать и установить пакет NuGet пакета Sdk для вызовов:

Откройте nuGet диспетчер пакетов, выбрав инструменты>NuGet диспетчер пакетов> Manage NuGet Packages for Solution.
Выберите "Обзор" и введите Azure.Communication.Calling.WindowsClient в поле поиска.
Убедитесь, что установлен флажок "Включить предварительную версию ".
Выберите пакет Azure.Communication.Calling.WindowsClient, а затем выберите Azure.Communication.Calling.WindowsClient 1.4.0-beta.1 или более позднюю версию.
Установите флажок, соответствующий проекту Службы коммуникации Azure на правой панели.
Выберите Установить.

Методы присоединения к собранию

Чтобы присоединиться к собранию CallAgent.JoinAsync Teams, используйте метод и передайте его JoinMeetingLocator JoinCallOptions.

Идентификатор собрания и секретный код

Он TeamsMeetingIdLocator находит собрание с помощью идентификатора собрания и секретного кода. Их можно найти в разделе сведений о присоединении к собранию 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.JoinAsync как показано ниже.

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

Поделиться через

Присоединение к собранию команд

Необходимые компоненты

Установка пакета SDK

Инициализация обязательных объектов

Управление подключением пакета SDK к инфраструктуре Майкрософт

Методы присоединения к собранию

Настройка системы

Создание проекта Visual Studio

Установка пакета и зависимостей с помощью NuGet диспетчер пакетов

Методы присоединения к собранию

Идентификатор собрания и секретный код

Ссылка на собрание

Координаты собрания

Присоединение к собранию с помощью указателей

Настройка системы

Создание проекта Visual Studio

Установка пакета и зависимостей с помощью NuGet диспетчер пакетов

Методы присоединения к собранию

Идентификатор собрания и секретный код

Ссылка на собрание

Присоединение к собранию с помощью указателей

Настройка системы

Создание проекта Visual Studio

Установка пакета и зависимостей с помощью NuGet диспетчер пакетов

Методы присоединения к собранию

Идентификатор собрания и секретный код

Ссылка на собрание

Координаты собрания

Присоединение к собранию с помощью указателей

Следующие шаги

Обратная связь

Дополнительные ресурсы