call リソースの種類

名前空間: microsoft.graph

アプリケーションに関して着信が存在する場合か、アプリケーションによって communications/calls で POST を介して発信が作成されると、call リソースが作成されます。

通話はピアツーピアまたはグループ通話として設定できます。 グループ通話の作成またはグループ通話への参加を行うには、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"}

メソッド

メソッド	戻り値の型	説明
Get	call	call オブジェクトのプロパティを読み取ります。
Delete	なし	アクティブな call を削除または切断します。
KeepAlive	なし	通話でアクティブな状態を継続させます。
Call 処理
応答する	なし	着信に応答します。
拒否する	なし	着信を拒否します。
リダイレクトする	なし	着信をリダイレクトします。
転送する	なし	通話の転送
グループ通話
参加者を一覧表示する	participant コレクション	participant オブジェクト コレクションを取得します。
参加者を招待する	commsOperation	アクティブな通話に参加者を招待します。
参加者をミュートする	muteParticipantOperation	グループ通話の参加者をミュートします。
対話型音声応答
PlayPrompt	playPromptOperation	通話でプロンプトを再生します。
RecordResponse	recordOperation	呼び出し元からの短い音声応答を録音します。
CancelMediaProcessing	commsOperation	メディア処理を取り消します。
SubscribeToTone	commsOperation	DTMF トーンを登録します。
自分の参加に関する操作
ミュートする	muteParticipantOperation	通話で自分をミュートします。
ミュート解除する	unmuteParticipantOperation	通話で自分のミュートを解除します。
ChangeScreenSharingRole	なし	通話中に画面共有を開始および停止します。
レコーディング操作
UpdateRecordingStatus	updateRecordingStatusOperation	レコーディングの状態を更新します。
ログイン操作
デバイスの品質データのログ記録	teleconferenceDeviceQuality	ビデオ遠隔会議デバイスの品質データをログに記録します。

プロパティ

プロパティ	型	説明
callbackUri	String	コールバック時のコールバック URL。 https である必要があります。
callChainId	String	1 つの会議におけるすべての参加者の通話を表す一意識別子、または P2P 通話における 2 人の参加者の通話を表す一意識別子。 これは、Microsoft.Graph.Call.CallChainId からコピーする必要があります。
callRoutes	callRoute コレクション	再通話したときのルーティング情報。読み取り専用です。
chatInfo	chatInfo	チャット情報。 会議に参加するために必要な情報。
方向	callDirection	通話方向。 使用可能な値: incoming、outgoing。 読み取り専用です。
id	String	通話 ID。読み取り専用。
mediaConfig	appHostedMediaConfig または serviceHostedMediaConfig	メディア構成。必須。
mediaState	callMediaState	読み取り専用です。通話メディアの状態。
meetingInfo	organizerMeetingInfo または tokenMeetingInfo	会議に参加するために必要な会議情報。
文字起こし	callTranscriptionInfo	通話の文字起こし情報。読み取り専用です。
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	読み取り専用です。
incomingContext	incomingContext	着信通話に関連付けられた呼び出しコンテキスト。

関係

リレーションシップ	型	説明
operations	commsOperationコレクション	読み取り専用。Null 許容型です。
participants	participant コレクション	読み取り専用。Null 許容型です。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "callbackUri": "String",
  "callChainId": "String",
  "chatInfo": {"@odata.type": "#microsoft.graph.chatInfo"},
  "direction": "incoming | outgoing",
  "id": "String (identifier)",
  "mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
  "mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
  "meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},  
  "transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
  "myParticipantId": "String",
  "replacesContext": "String",
  "requestedModalities": ["unknown | audio | video | videoBasedScreenSharing | data"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "incoming | establishing | ringing | established | hold | transferring | transferAccepted | redirecting | terminating | terminated",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}