Call Media - Play

Service:

Communication

API-versie:

2024-09-15

Hiermee wordt audio afgespeeld aan deelnemers aan het gesprek.

POST {endpoint}/calling/callConnections/{callConnectionId}:play?api-version=2024-09-15

URI-parameters

Name	In	Vereist	Type	Description
callConnectionId	path	True	string	De oproepverbindings-id.
endpoint	path	True	string url	Het eindpunt van de Azure Communication-resource.
api-version	query	True	string	De versie van de API die moet worden aangeroepen.

Aanvraagkoptekst

Name	Vereist	Type	Description
Authorization	True	string	Een Azure Communication Services-toegangstoken voor gebruikers.

Aanvraagbody

Name	Vereist	Type	Description
playSources	True	PlaySource[]	De bron van de audio die moet worden afgespeeld.
interruptCallMediaOperation		boolean	Als afspelen is ingesteld, kunnen er andere bestaande aanvragen in de wachtrij worden geplaatst/momenteel worden verwerkt.
operationCallbackUri		string	Stel een callback-URI in waarmee de standaard callback-URI wordt overschreven die is ingesteld door CreateCall/AnswerCall voor deze bewerking. Deze instelling is per actie. Als dit niet is ingesteld, wordt de standaard callback-URI die is ingesteld door CreateCall/AnswerCall gebruikt.
operationContext		string	De waarde om de context van de bewerking te identificeren.
playOptions		PlayOptions	Hiermee definieert u opties voor het afspelen van de audio.
playTo		CommunicationIdentifierModel[]	De lijst met gespreksdeelnemers worden audio afgespeeld. Wordt afgespeeld aan iedereen in het gesprek wanneer deze niet is opgegeven.

Antwoorden

Name	Type	Description
202 Accepted		De service heeft de play-aanvraag geaccepteerd en begint met het verwerken ervan. U ontvangt een PlayCompleted- of PlayFailed-gebeurtenis op de opgegeven callback-URI om u bij te werken over de status van de aanvraag.
Other Status Codes	CommunicationErrorResponse	Fout

Beveiliging

Authorization

Een Azure Communication Services-toegangstoken voor gebruikers.

Type: apiKey
In: header

Voorbeelden

CallMedia_Play

Voorbeeldaanvraag

HTTP

POST https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c:play?api-version=2024-09-15

{
  "playSources": [
    {
      "kind": "file",
      "playSourceCacheId": "string",
      "file": {
        "uri": "https://some.file.azure.com/sample.wav"
      }
    }
  ],
  "playTo": [
    {
      "kind": "communicationUser",
      "communicationUser": {
        "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_ae9e3307-f56e-44be-8934-80a63f080538"
      }
    }
  ],
  "playOptions": {
    "loop": true
  },
  "operationCallbackUri": "https://app.contoso.com/callback"
}

Voorbeeldrespons

Statuscode:

202

Definities

Name	Description
FileSource
PlayOptions
PlayRequest
PlaySource
PlaySourceType	Definieert het type play-bron
SsmlSource
TextSource
VoiceKind	Type stemtype

FileSource

Name	Type	Description
uri	string	URI voor het afspelen van het audiobestand

PlayOptions

Name	Type	Description
loop	boolean	De optie om de meegeleverde audiobron in lus af te spelen wanneer deze is ingesteld op waar

PlayRequest

Name	Type	Description
interruptCallMediaOperation	boolean	Als afspelen is ingesteld, kunnen er andere bestaande aanvragen in de wachtrij worden geplaatst/momenteel worden verwerkt.
operationCallbackUri	string	Stel een callback-URI in waarmee de standaard callback-URI wordt overschreven die is ingesteld door CreateCall/AnswerCall voor deze bewerking. Deze instelling is per actie. Als dit niet is ingesteld, wordt de standaard callback-URI die is ingesteld door CreateCall/AnswerCall gebruikt.
operationContext	string	De waarde om de context van de bewerking te identificeren.
playOptions	PlayOptions	Hiermee definieert u opties voor het afspelen van de audio.
playSources	PlaySource[]	De bron van de audio die moet worden afgespeeld.
playTo	CommunicationIdentifierModel[]	De lijst met gespreksdeelnemers worden audio afgespeeld. Wordt afgespeeld aan iedereen in het gesprek wanneer deze niet is opgegeven.

PlaySource

Name	Type	Description
file	FileSource	Hiermee definieert u de brongegevens van het bestand die moeten worden gebruikt voor afspelen
kind	PlaySourceType	Definieert het type play-bron
playSourceCacheId	string	Definieert de id die moet worden gebruikt voor het opslaan van gerelateerde media in de cache
ssml	SsmlSource	Definieert de brongegevens van ssml (Speech Synthesis Markup Language) die moeten worden gebruikt voor afspelen
text	TextSource	Definieert de tekstbrongegevens die moeten worden gebruikt voor afspelen

PlaySourceType

Definieert het type play-bron

Name	Type	Description
file	string
ssml	string
text	string

SsmlSource

Name	Type	Description
customVoiceEndpointId	string	Eindpunt waar de aangepaste stem is geïmplementeerd.
ssmlText	string	Ssml-tekenreeks voor de cognitieve service die moet worden afgespeeld

TextSource

Name	Type	Description
customVoiceEndpointId	string	Eindpunt waar de aangepaste stem is geïmplementeerd.
sourceLocale	string	De landinstellingen van de brontaal die u wilt afspelen, verwijzen hier naar beschikbare landinstellingen:
text	string	Tekst voor de cognitieve service die moet worden afgespeeld
voiceKind	VoiceKind	Type stemtype
voiceName	string	Stemnaam die moet worden afgespeeld Raadpleeg hier beschikbare stemmen voor tekst-naar-spraak:

VoiceKind

Type stemtype

Name	Type	Description
female	string
male	string