Call Media - Start Continuous Dtmf Recognition

Service:

Communication

Version d'API:

2024-09-15

Démarrez la reconnaissance Dtmf continue en s’abonnant aux tonalités.

POST {endpoint}/calling/callConnections/{callConnectionId}:startContinuousDtmfRecognition?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
targetParticipant	True	CommunicationIdentifierModel
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.

Réponses

Nom	Type	Description
200 OK		Le service a démarré la reconnaissance continue dtmf. Vous recevrez l’événement ContinuousDtmfRecognitionToneReceived, ContinuousDtmfRecognitionToneFailed ou ContinuousDtmfRecognitionStopped au niveau de votre URI de rappel spécifié. La reconnaissance dtmf continue peut s’exécuter en parallèle avec d’autres opérations multimédias. Par exemple, si l’opération Recognize est également active et qu’une dtmf est détectée, les événements ContinuousDtmfRecognitionToneReceived et RecognizeCompleted sont reçus.
Other Status Codes	CommunicationErrorResponse	Erreur

Sécurité

Authorization

Jeton d’accès utilisateur Azure Communication Services.

Type: apiKey
Dans: header

Exemples

CallMedia_StartContinuousDtmfRecognition

Exemple de requête

HTTP

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

{
  "targetParticipant": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
    }
  }
}

Exemple de réponse

Code d’état:

200

Définitions

ContinuousDtmfRecognitionRequest

Nom	Type	Description
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.
targetParticipant	CommunicationIdentifierModel