call リソースの種類

名前空間: microsoft.graph

呼び出しリソースは、アプリケーションの着信呼び出しがある場合、または アプリケーションが を介してPOST新しい発信呼び出しを作成するときに作成されますcommunications/calls

通話はピアツーピアまたはグループ通話として設定できます。 グループ呼び出しを作成または参加するには、 と meetingInfoを指定しますchatInfo。 これらの値が指定されていない場合は、新しいグループ呼び出しが自動的に作成されます。 着信呼び出しの場合は、アプリケーションがクラッシュした場合にアプリケーションが呼び出しに再参加できるように、これらの値を高可用性ストアに記録します。

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

メソッド

メソッド 戻り値の型 説明
Get call call オブジェクトのプロパティを読み取ります。
Delete なし アクティブな call を削除または切断します。
KeepAlive なし 通話でアクティブな状態を継続させます。
通話処理
応答する なし 着信に応答します。
拒否する なし 着信を拒否します。
リダイレクトする なし 着信をリダイレクトします。
転送する なし 通話の転送
グループ呼び出し
参加者を一覧表示する participant コレクション participant オブジェクト コレクションを取得します。
参加者を招待する commsOperation アクティブな通話に参加者を招待します。
参加者をミュートする muteParticipantOperation グループ通話の参加者をミュートします。
audioRoutingGroup を作成する audioRoutingGroup audioRoutingGroups コレクションに投稿して、新しい audioRoutingGroup を作成します。
audioRoutingGroups を一覧表示する (List audioRoutingGroups) audioRoutingGroup コレクション audioRoutingGroup オブジェクト コレクションを取得します。
大規模なギャラリー ビュー addLargeGalleryViewOperation 大規模なギャラリー ビューを呼び出しに追加します。
対話型音声応答
PlayPrompt playPromptOperation 通話でプロンプトを再生します。
RecordResponse recordOperation 呼び出し元からの短い音声応答を録音します。
CancelMediaProcessing commsOperation メディア処理を取り消します。
SubscribeToTone commsOperation DTMF トーンを登録します。
SendDtmfTones commsOperation 通話で DTMF トーンを送信します。
自己参加者操作
ミュートする muteParticipantOperation 通話で自分をミュートします。
ミュート解除する unmuteParticipantOperation 通話で自分のミュートを解除します。
ChangeScreenSharingRole なし 通話中に画面共有を開始および停止します。
レコーディング操作
UpdateRecordingStatus 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 organizerMeetingInfotokenMeetingInfo、または joinMeetingIdMeetingInfo 会議の情報。 会議のシナリオに必要な情報。
myParticipantId String 読み取り専用です。
requestedModalities modality コレクション 要求されたモダリティの一覧。 可能な値は、unknownaudiovideovideoBasedScreenSharingdata です。
resultInfo resultInfo 結果の情報。 たとえば、結果は終了理由を保持できます。 読み取り専用です。
source participantInfo 通話の発信者。
state callState 通話状態。 可能な値は、incomingestablishingringingestablishedholdtransferringtransferAcceptedredirectingterminatingterminated です。 読み取り専用です。
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",  
  "replacesContext": "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"},
}