Call Media - Start Continuous Dtmf Recognition

サービス:

Communication

API バージョン:

2024-09-15

トーンをサブスクライブして、Dtmf の継続的な認識を開始します。

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

URI パラメーター

名前	/	必須	型	説明
callConnectionId	path	True	string	呼び出し接続 ID
endpoint	path	True	string url	Azure Communication リソースのエンドポイント。
api-version	query	True	string	呼び出す API のバージョン。

要求ヘッダー

名前	必須	型	説明
Authorization	True	string	Azure Communication Services ユーザー アクセス トークン。

要求本文

名前	必須	型	説明
targetParticipant	True	CommunicationIdentifierModel
operationCallbackUri		string	この操作の CreateCall/AnswerCall によって設定された既定のコールバック URI をオーバーライドするコールバック URI を設定します。 このセットアップはアクションごとに行われます。 これが設定されていない場合は、CreateCall/AnswerCall によって設定された既定のコールバック URI が使用されます。
operationContext		string	操作のコンテキストを識別する値。

応答

名前	型	説明
200 OK		サービスが継続的な dtmf 認識を開始しました。 指定したコールバック URI で ContinuousDtmfRecognitionToneReceived、ContinuousDtmfRecognitionToneFailed、または ContinuousDtmfRecognitionStopped イベントを受け取ります。 継続的な dtmf 認識は、他のメディア操作と並行して実行できます。 たとえば、Recognize 操作もアクティブで、dtmf が検出された場合、ContinuousDtmfRecognitionToneReceived イベントと RecognizeCompleted イベントの両方が受信されます。
Other Status Codes	CommunicationErrorResponse	エラー

セキュリティ

Authorization

Azure Communication Services ユーザー アクセス トークン。

型: apiKey
/: header

例

CallMedia_StartContinuousDtmfRecognition

要求のサンプル

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

応答のサンプル

状態コード:

200

定義

ContinuousDtmfRecognitionRequest

名前	型	説明
operationCallbackUri	string	この操作の CreateCall/AnswerCall によって設定された既定のコールバック URI をオーバーライドするコールバック URI を設定します。 このセットアップはアクションごとに行われます。 これが設定されていない場合は、CreateCall/AnswerCall によって設定された既定のコールバック URI が使用されます。
operationContext	string	操作のコンテキストを識別する値。
targetParticipant	CommunicationIdentifierModel