Delen via

Azure Communication Call Automation-clientbibliotheek voor JavaScript - versie 1.5.0

Dit pakket bevat een JavaScript SDK voor Azure Communication Call Automation. Gespreksautomatisering biedt ontwikkelaars de mogelijkheid om op servers gebaseerde, intelligente oproepwerkstromen en oproepopname voor spraak- en PSTN-kanalen te bouwen.

Overzicht van de | Productdocumentatie voor Gespreksautomatisering

Slag

Voorwaarden

Installeren

npm install @azure/communication-call-automation

Browserondersteuning

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze bundeldocumentatievoor meer informatie over hoe u dit doet.

Sleutelbegrippen

Naam Beschrijving
Bel AutomationClient CallAutomationClient is de primaire interface voor ontwikkelaars die deze clientbibliotheek gebruiken. Het kan worden gebruikt om aanroepen te initiëren door createCall of answerCall.
Verbinding bellen CallConnection een doorlopend gesprek vertegenwoordigt. Zodra de oproep tot stand is gebracht met createCall of answerCall, kunnen verdere acties worden uitgevoerd voor de oproep, zoals transfer of addParticipant.
Bel Media CallMedia kan worden gebruikt voor het uitvoeren van mediagerelateerde acties, zoals play, om mediabestand af te spelen. Dit kan worden opgehaald uit gevestigde CallConnection.
Gespreksrecording CallRecording kan worden gebruikt voor het vastleggen van gerelateerde acties, zoals startRecording. Dit kan worden opgehaald uit CallAutomationClient.
Callback-evenementen Callback-gebeurtenissen zijn gebeurtenissen die tijdens de duur van het gesprek worden teruggestuurd. Het geeft informatie en de status van het gesprek, zoals CallConnected. CallbackUrl moet worden opgegeven tijdens createCall en answerCall, en terugbelgebeurtenissen worden naar deze URL verzonden. U kunt deze gebeurtenissen ontleden callAutomationEventParser wanneer deze binnenkomen.
Gebeurtenis voor inkomende oproep Wanneer een inkomende oproep plaatsvindt (die kan worden beantwoord met answerCall), wordt de eventgrid-gebeurtenis van de inkomende oproep verzonden. Dit verschilt van de bovenstaande Callback-gebeurtenissen en moet worden ingesteld op Azure Portal. Zie Inkomende oproep voor meer informatie.

Voorbeelden

CallAutomationClient initialiseren

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

Oproep maken

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

Media afspelen

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]);

Probleemoplossing

Loggen

Het inschakelen van logboekregistratie kan helpen nuttige informatie over fouten te ontdekken. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de omgevingsvariabele AZURE_LOG_LEVEL in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door setLogLevel aan te roepen in de @azure/logger:

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

setLogLevel("info");

Volgende stappen

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de gids voor bijdragen voor meer informatie over het bouwen en testen van de code.