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

Клиентская библиотека автоматизации вызовов связи Azure для JavaScript — версия 1.4.0

Этот пакет содержит пакет SDK JavaScript для автоматизации вызовов коммуникации Azure. Автоматизация вызовов предоставляет разработчикам возможность создавать серверные рабочие процессы, интеллектуальные рабочие процессы звонков и записывать звонки для каналов голосовой связи и ТСОП.

Обзор документации по автоматизации вызовов | продукта

Начало работы

Необходимые условия

Установка

npm install @azure/communication-call-automation

Поддержка браузера

Пакет JavaScript

Чтобы использовать эту клиентную библиотеку в браузере, сначала необходимо использовать пакет. Дополнительные сведения о том, как это сделать, см. в нашей документации по .

Основные понятия

Имя Описание
CallAutomationClient (Клиент CallAutomation) CallAutomationClient — это основной интерфейс для разработчиков с помощью этой клиентской библиотеки. Его можно использовать для инициирования вызовов createCall или answerCall.
CallConnection CallConnection представляет текущий вызов. После установки вызова с createCall или answerCallможно выполнить дальнейшие действия для вызова, например transfer или addParticipant.
CallMedia CallMedia можно использовать для выполнения связанных с мультимедиа действий, таких как play, для воспроизведения файла мультимедиа. Это можно получить из установленных CallConnection.
Запись звонков CallRecording можно использовать для записи связанных действий, таких как startRecording. Это можно получить из CallAutomationClient.

Примеры

Инициализация CallAutomationClient

import { DefaultAzureCredential } from "@azure/identity";
import { CallAutomationClient } from "@azure/communication-call-automation";

// Your unique Azure Communication service endpoint
const credential = new DefaultAzureCredential();
const endpointUrl = "<ENDPOINT>";
const callAutomationClient = new CallAutomationClient(endpointUrl, credential);

Создание вызова

import { DefaultAzureCredential } from "@azure/identity";
import { CallAutomationClient } from "@azure/communication-call-automation";

// Your unique Azure Communication service endpoint
const credential = new DefaultAzureCredential();
const endpointUrl = "<ENDPOINT>";
const callAutomationClient = new CallAutomationClient(endpointUrl, credential);

// target endpoint for ACS User
const target = {
  communicationUserId: "8:acs:...",
};

// make invitation
const callInvite = {
  targetParticipant: target,
};

// callback url to receive callback events
const callbackUrl = "https://<MY-EVENT-HANDLER-URL>/events";

// send out the invitation, creating call
const response = await callAutomationClient.createCall(callInvite, callbackUrl);

Воспроизведение мультимедиа

import { DefaultAzureCredential } from "@azure/identity";
import { CallAutomationClient, FileSource } from "@azure/communication-call-automation";

// Your unique Azure Communication service endpoint
const credential = new DefaultAzureCredential();
const endpointUrl = "<ENDPOINT>";
const callAutomationClient = new CallAutomationClient(endpointUrl, credential);

const target = { communicationUserId: "8:acs:..." };
const callInvite = { targetParticipant: target };
const callbackUrl = "https://<MY-EVENT-HANDLER-URL>/events";

const createCallResult = await callAutomationClient.createCall(callInvite, callbackUrl);
const callConnection = createCallResult.callConnection;
// from callconnection of response above, play media of media file
const myFile: FileSource = { url: "https://<FILE-SOURCE>/<SOME-FILE>.wav", kind: "fileSource" };
const response = await callConnection.getCallMedia().playToAll([myFile]);

Устранение неполадок

Лесозаготовка

Включение ведения журнала может помочь выявить полезные сведения о сбоях. Чтобы просмотреть журнал HTTP-запросов и ответов, задайте для переменной среды AZURE_LOG_LEVEL значение info. Кроме того, ведение журнала можно включить во время выполнения путем вызова setLogLevel в @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Дальнейшие действия

Способствует

Если вы хотите внести свой вклад в эту библиотеку, ознакомьтесь с руководством по вкладу, чтобы узнать больше о том, как создавать и тестировать код.