Call Media - Play

Serviço:

Communication

Versão da API:

2024-09-15

Reproduz áudio para os participantes da chamada.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
callConnectionId	path	True	string	A ID de conexão de chamada.
endpoint	path	True	string url	O ponto de extremidade do recurso de Comunicação do Azure.
api-version	query	True	string	Versão da API a invocar.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Authorization	True	string	Um token de acesso de usuário dos Serviços de Comunicação do Azure.

Corpo do Pedido

Name	Necessário	Tipo	Description
playSources	True	PlaySource[]	A fonte do áudio a ser reproduzido.
interruptCallMediaOperation		boolean	Se o set play pode entrar em outras solicitações existentes em fila/processamento no momento.
operationCallbackUri		string	Defina um URI de retorno de chamada que substitua o URI de retorno de chamada padrão definido por CreateCall/AnswerCall para esta operação. Esta configuração é por ação. Se isso não estiver definido, o URI de retorno de chamada padrão definido por CreateCall/AnswerCall será usado.
operationContext		string	O valor para identificar o contexto da operação.
playOptions		PlayOptions	Define opções para reproduzir o áudio.
playTo		CommunicationIdentifierModel[]	A lista de participantes da chamada reproduz o áudio fornecido. Toca para todos na chamada quando não é fornecido.

Respostas

Name	Tipo	Description
202 Accepted		O serviço aceitou o pedido de jogo e começará a processá-lo. Você receberá o evento PlayCompleted ou PlayFailed no URI de retorno de chamada especificado para atualizá-lo sobre o status da solicitação.
Other Status Codes	CommunicationErrorResponse	Erro

Segurança

Authorization

Um token de acesso de usuário dos Serviços de Comunicação do Azure.

Tipo: apiKey
Em: header

Exemplos

CallMedia_Play

Pedido de amostra

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

Resposta da amostra

Código de estado:

202

Definições

Name	Description
FileSource
PlayOptions
PlayRequest
PlaySource
PlaySourceType	Define o tipo de fonte de reprodução
SsmlSource
TextSource
VoiceKind	Tipo de tipo de voz

FileSource

Name	Tipo	Description
uri	string	Uri para o arquivo de áudio a ser reproduzido

PlayOptions

Name	Tipo	Description
loop	boolean	A opção de reproduzir a fonte de áudio fornecida em loop quando definida como true

PlayRequest

Name	Tipo	Description
interruptCallMediaOperation	boolean	Se o set play pode entrar em outras solicitações existentes em fila/processamento no momento.
operationCallbackUri	string	Defina um URI de retorno de chamada que substitua o URI de retorno de chamada padrão definido por CreateCall/AnswerCall para esta operação. Esta configuração é por ação. Se isso não estiver definido, o URI de retorno de chamada padrão definido por CreateCall/AnswerCall será usado.
operationContext	string	O valor para identificar o contexto da operação.
playOptions	PlayOptions	Define opções para reproduzir o áudio.
playSources	PlaySource[]	A fonte do áudio a ser reproduzido.
playTo	CommunicationIdentifierModel[]	A lista de participantes da chamada reproduz o áudio fornecido. Toca para todos na chamada quando não é fornecido.

PlaySource

Name	Tipo	Description
file	FileSource	Define as informações de origem do arquivo a serem usadas para reprodução
kind	PlaySourceType	Define o tipo de fonte de reprodução
playSourceCacheId	string	Define o identificador a ser usado para armazenar em cache mídia relacionada
ssml	SsmlSource	Define as informações de origem do ssml (Speech Synthesis Markup Language) a serem usadas para jogar
text	TextSource	Define as informações de origem do texto a serem usadas para reprodução

PlaySourceType

Define o tipo de fonte de reprodução

Name	Tipo	Description
file	string
ssml	string
text	string

SsmlSource

Name	Tipo	Description
customVoiceEndpointId	string	Ponto de extremidade onde a voz personalizada foi implantada.
ssmlText	string	String Ssml para o serviço cognitivo a ser jogado

TextSource

Name	Tipo	Description
customVoiceEndpointId	string	Ponto de extremidade onde a voz personalizada foi implantada.
sourceLocale	string	Localidade do idioma de origem a ser reproduzida Consulte as localidades disponíveis aqui:
text	string	Texto para o serviço cognitivo a ser jogado
voiceKind	VoiceKind	Tipo de tipo de voz
voiceName	string	Nome da voz a ser reproduzido Consulte as vozes de conversão de texto em fala disponíveis aqui:

VoiceKind

Tipo de tipo de voz

Name	Tipo	Description
female	string
male	string