Call Media - Play

Service:

Communication

Version d'API:

2024-09-15

Lit l’audio pour les participants à l’appel.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
callConnectionId	path	True	string	ID de connexion d’appel.
endpoint	path	True	string url	Point de terminaison de la ressource Azure Communication.
api-version	query	True	string	Version de l’API à appeler.

En-tête de la demande

Nom	Obligatoire	Type	Description
Authorization	True	string	Jeton d’accès utilisateur Azure Communication Services.

Corps de la demande

Nom	Obligatoire	Type	Description
playSources	True	PlaySource[]	Source de l’audio à lire.
interruptCallMediaOperation		boolean	Si le jeu est défini, il est possible d’effectuer une chalandage dans d’autres demandes mises en file d’attente/en cours de traitement.
operationCallbackUri		string	Définissez un URI de rappel qui remplace l’URI de rappel par défaut défini par CreateCall/AnswerCall pour cette opération. Cette configuration est par action. S’il n’est pas défini, l’URI de rappel par défaut défini par CreateCall/AnswerCall sera utilisé.
operationContext		string	Valeur permettant d’identifier le contexte de l’opération.
playOptions		PlayOptions	Définit les options de lecture de l’audio.
playTo		CommunicationIdentifierModel[]	Liste des participants à l’appel qui jouent l’audio fourni. Joue à tout le monde dans l’appel lorsqu’il n’est pas fourni.

Réponses

Nom	Type	Description
202 Accepted		Le service a accepté la demande de lecture et commencera à le traiter. Vous recevrez l’événement PlayCompleted ou PlayFailed à l’URI de rappel spécifié pour vous mettre à jour sur l’état de la demande.
Other Status Codes	CommunicationErrorResponse	Erreur

Sécurité

Authorization

Jeton d’accès utilisateur Azure Communication Services.

Type: apiKey
Dans: header

Exemples

CallMedia_Play

Exemple de requête

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"
}

Exemple de réponse

Code d’état:

202

Définitions

Nom	Description
FileSource
PlayOptions
PlayRequest
PlaySource
PlaySourceType	Définit le type de la source de lecture
SsmlSource
TextSource
VoiceKind	Type de type vocal

FileSource

Nom	Type	Description
uri	string	URI du fichier audio à lire

PlayOptions

Nom	Type	Description
loop	boolean	Option permettant de lire la source audio fournie en boucle lorsqu’elle est définie sur true

PlayRequest

Nom	Type	Description
interruptCallMediaOperation	boolean	Si le jeu est défini, il est possible d’effectuer une chalandage dans d’autres demandes mises en file d’attente/en cours de traitement.
operationCallbackUri	string	Définissez un URI de rappel qui remplace l’URI de rappel par défaut défini par CreateCall/AnswerCall pour cette opération. Cette configuration est par action. S’il n’est pas défini, l’URI de rappel par défaut défini par CreateCall/AnswerCall sera utilisé.
operationContext	string	Valeur permettant d’identifier le contexte de l’opération.
playOptions	PlayOptions	Définit les options de lecture de l’audio.
playSources	PlaySource[]	Source de l’audio à lire.
playTo	CommunicationIdentifierModel[]	Liste des participants à l’appel qui jouent l’audio fourni. Joue à tout le monde dans l’appel lorsqu’il n’est pas fourni.

PlaySource

Nom	Type	Description
file	FileSource	Définit les informations de source de fichier à utiliser pour lecture
kind	PlaySourceType	Définit le type de la source de lecture
playSourceCacheId	string	Définit l’identificateur à utiliser pour la mise en cache des supports associés
ssml	SsmlSource	Définit les informations sources ssml(Speech Synthesis Markup Language) à utiliser pour la lecture
text	TextSource	Définit les informations de source de texte à utiliser pour lecture

PlaySourceType

Définit le type de la source de lecture

Nom	Type	Description
file	string
ssml	string
text	string

SsmlSource

Nom	Type	Description
customVoiceEndpointId	string	Point de terminaison où la voix personnalisée a été déployée.
ssmlText	string	Chaîne Ssml pour que le service cognitif soit lu

TextSource

Nom	Type	Description
customVoiceEndpointId	string	Point de terminaison où la voix personnalisée a été déployée.
sourceLocale	string	Les paramètres régionaux de langue source à lire font référence aux paramètres régionaux disponibles ici :
text	string	Texte du service cognitif à lire
voiceKind	VoiceKind	Type de type vocal
voiceName	string	Nom de la voix à lire Reportez-vous aux voix de synthèse vocale disponibles ici :

VoiceKind

Type de type vocal

Nom	Type	Description
female	string
male	string