call リソースの種類
名前空間: microsoft.graph
呼び出しリソースは、アプリケーションの着信呼び出しがある場合、またはアプリケーションがcommunications/callsのPOSTを介して新しい発信呼び出しを作成するときに作成されます。
通話はピアツーピアまたはグループ通話として設定できます。 グループ呼び出しを作成または参加するには、 chatInfo と meetingInfoを指定します。 これらの値が指定されていない場合は、新しいグループ呼び出しが自動的に作成されます。 着信呼び出しの場合は、アプリケーションがクラッシュした場合にアプリケーションが呼び出しに再参加できるように、これらの値を高可用性ストアに記録します。
同じ ID を複数回招待することはできませんが、アプリケーションが同じ会議に複数回参加する可能性があります。 アプリケーションが通話に参加を求める際は、毎回異なる ID を指定する必要があります。これにより、別々の参加者としてクライアントに表示されます。
注: 参加 URL は、Microsoft Teams を使用してスケジュールを行った会議から入手できます。 次に示される方法で、
chatInfoおよびmeetingInfoとして入力するためのデータを URL から抽出します。
https://teams.microsoft.com/l/meetup-join/19%3ameeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%224b444206-207c-42f8-92a6-e332b41c88a2%22%7d
次のようになります。
https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLThmNmEtOGQ3M2E0ODdmZDZk@thread.v2/0?context={"Tid":"72f988bf-86f1-41af-91ab-2d7cd011db47","Oid":"4b444206-207c-42f8-92a6-e332b41c88a2"}
注:
このリソースには、次の既知の問題が関連付けられています。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | 通話 | 呼び出しを作成すると、ボットは新しい発信ピアツーピア通話またはグループ通話を作成したり、既存の会議に参加したりできます。 |
| Get | call | call オブジェクトのプロパティを読み取ります。 |
| 削除/切断する | なし | アクティブな call を削除または切断します。 |
| キープ アライブ | なし | 通話でアクティブな状態を継続させます。 |
| 通話処理 | ||
| 応答する | なし | 着信に応答します。 |
| 拒否する | なし | 着信を拒否します。 |
| リダイレクトする | なし | 着信をリダイレクトします。 |
| 転送する | なし | 通話の転送 |
| グループ呼び出し | ||
| List | participant コレクション | participant オブジェクト コレクションを取得します。 |
| 参加者を招待する | commsOperation | アクティブな通話に参加者を招待します。 |
| 参加者をミュートする | muteParticipantOperation | グループ通話の参加者をミュートします。 |
| Create | audioRoutingGroup | audioRoutingGroups コレクションに投稿して、新しい audioRoutingGroup を作成します。 |
| オーディオ ルーティング グループを一覧表示する | audioRoutingGroup コレクション | audioRoutingGroup オブジェクト コレクションを取得します。 |
| 大規模なギャラリー ビュー | addLargeGalleryViewOperation | 大規模なギャラリー ビューを呼び出しに追加します。 |
| 対話型音声応答 | ||
| prompt を再生する | playPromptOperation | 通話でプロンプトを再生します。 |
| 応答を記録する | recordOperation | 呼び出し元からの短い音声応答を録音します。 |
| メディア処理を取り消す | commsOperation | メディア処理を取り消します。 |
| トーンを登録する | commsOperation | DTMF トーンを登録します。 |
| DTMF トーンを送信する | commsOperation | 通話で DTMF トーンを送信します。 |
| 自分の参加に関する操作 | ||
| アプリケーションをミュートする | muteParticipantOperation | 通話で自分をミュートします。 |
| アプリケーションのミュートを解除する | unmuteParticipantOperation | 通話で自分のミュートを解除します。 |
| 画面の共有の役割を変更する | なし | 通話中に画面共有を開始および停止します。 |
| レコーディング操作 | ||
| 記録状態を更新する | updateRecordingStatusOperation | レコーディングの状態を更新します。 |
| ログ記録操作 | ||
| 遠隔会議デバイスの品質データをログに記録する | teleconferenceDeviceQuality | ビデオ遠隔会議デバイスの品質データをログに記録します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| callbackUri | String | コールバックが配信されるコールバック URL。 HTTPS URL である必要があります。 |
| callChainId | String | 1 つの会議におけるすべての参加者の通話を表す一意識別子、または P2P 通話における 2 人の参加者の通話を表す一意識別子。 この識別子は、 Microsoft.Graph.Call.CallChainIdからコピーする必要があります。 |
| callOptions | outgoingCallOptions | 通話のオプション機能が含まれています。 |
| callRoutes | callRoute コレクション | 再通話したときのルーティング情報。 読み取り専用です。 |
| chatInfo | chatInfo | チャット情報。 会議に参加するために必要な情報。 |
| 方向 | callDirection | 通話方向。 使用可能な値は、 incoming または outgoingです。 読み取り専用です。 |
| id | String | 呼び出しの一意識別子。 読み取り専用です。 |
| incomingContext | incomingContext | 着信通話に関連付けられた呼び出しコンテキスト。 |
| mediaConfig | appHostedMediaConfig または serviceHostedMediaConfig | メディア構成。 必須です。 |
| mediaState | callMediaState | 読み取り専用です。 通話メディアの状態。 |
| meetingInfo | organizerMeetingInfo、 tokenMeetingInfo、または joinMeetingIdMeetingInfo | 会議の情報。 会議のシナリオに必要な情報。 |
| myParticipantId | String | 読み取り専用です。 |
| requestedModalities | modality コレクション | 要求されたモダリティの一覧。 可能な値は、unknown、audio、video、videoBasedScreenSharing、data です。 |
| resultInfo | resultInfo | 結果の情報。 たとえば、結果は終了理由を保持できます。 読み取り専用です。 |
| source | participantInfo | 通話の発信者。 |
| state | callState | 通話状態。 可能な値は、incoming、establishing、ringing、established、hold、transferring、transferAccepted、redirecting、terminating、terminated です。 読み取り専用です。 |
| subject | String | 会話の件名。 |
| Targets | invitationParticipantInfo コレクション | 通話対象。 ピア ツー ピア通話の作成に必要な情報。 |
| toneInfo | toneInfo | 読み取り専用です。 |
| 文字起こし | callTranscriptionInfo | 通話の文字起こし情報。 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| contentSharingSessions | contentSharingSession コレクション | 読み取り専用です。 Null 許容型。 |
| operations | commsOperationコレクション | 読み取り専用です。 Null 許容型。 |
| 参加者 | participant コレクション | 読み取り専用です。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"callbackUri": "String",
"callChainId": "String",
"callOptions": {"@odata.type": "#microsoft.graph.outgoingCallOptions"},
"chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
"contentSharingSessions": [{ "@odata.type": "microsoft.graph.contentSharingSession" }],
"direction": "String",
"id": "String (identifier)",
"mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
"mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
"meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
"myParticipantId": "String",
"requestedModalities": ["String"],
"resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
"source": {"@odata.type": "#microsoft.graph.participantInfo"},
"state": "String",
"subject": "String",
"targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
"toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"},
"transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
}