call 资源类型

命名空间：microsoft.graph

当应用程序有传入呼叫或应用程序通过 communications/calls 上的 POST 创建新的传出呼叫时，将创建 call 资源。

呼叫可设置为对等呼叫或群组通话。 要创建或加入群组通话，请提供 chatInfo 和 meetingInfo。 如果未提供这些项，则自动创建一个新的群组通话。 对于传入呼叫，将这些值记录在高可用性存储中，以便在应用程序崩溃时它可以重新加入呼叫。

尽管不能多次邀请相同的身份，但应用程序可以多次加入同一会议。 应用程序每次想要加入呼叫时，都必须提供单独的标识，以便客户端将其显示为不同的参与者。

请注意： 可从通过 Microsoft Teams 计划的会议中获取加入 URL。 从所示 URL 中提取数据来填充 chatInfo 和 meetingInfo。

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 对象的属性。
删除	无	删除或挂断活动 呼叫。
KeepAlive	无	确保通话不中断。
呼叫处理
Answer	无	应答传入呼叫。
Reject	无	拒绝传入呼叫。
重定向	无	重定向传入呼叫。
Transfer	无	转接呼叫
群组呼叫
List participants	participant 集合	获取参与者对象集合。
邀请参与者	commsOperation	邀请参与者加入活动呼叫。
参与者静音	muteParticipantOperation	群组通话中参与者静音。
Interactive-Voice-Response
PlayPrompt	playPromptOperation	在呼叫中播放提示。
RecordResponse	recordOperation	录制来自呼叫方的简短音频回复。
CancelMediaProcessing	commsOperation	取消媒体处理。
SubscribeToTone	commsOperation	订阅 DTMF 音。
Self Participant Operations
Mute	muteParticipantOperation	在呼叫中将自己设为静音。
Unmute	unmuteParticipantOperation	在呼叫中将自己取消静音。
ChangeScreenSharingRole	无	在呼叫中开始和停止共享屏幕。
记录操作
UpdateRecordingStatus	updateRecordingStatusOperation	更新记录状态。
日志记录操作
记录设备质量数据	teleconferenceDeviceQuality	记录视频电话会议设备质量数据。

属性

属性	类型	说明
callbackUri	字符串	用于传递回调的回调 URL。 必须是 https。
callChainId	String	一个针对会议中所有参与者的通话的唯一标识符，或一个针对 P2P 通话中两位参与者的通话的唯一标识符。 需要从 Microsoft.Graph.Call.CallChainId 复制它。
callRoutes	callRoute 集合	有关如何重定向呼叫的路由信息。只读。
chatInfo	chatInfo	聊天信息。 加入会议所需的信息。
direction	callDirection	呼叫的方向。 可取值为 incoming 或 outgoing。 只读。
id	字符串	来电显示。只读。
mediaConfig	appHostedMediaConfig 或 serviceHostedMediaConfig	媒体配置。必需。
mediaState	callMediaState	只读。通话媒体状态。
meetingInfo	organizerMeetingInfo 或 tokenMeetingInfo	加入会议所需的会议信息。
transcription	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 集合	只读。可为空。
participants	participant 集合	只读。可为空。

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