Tipo de recurso call

Artículo
03/26/2023

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

El recurso de llamada se crea cuando hay una llamada entrante para la aplicación o la aplicación crea una nueva llamada saliente a través de en POSTapp/calls.

Las llamadas pueden configurarse como de punto a punto o como llamada grupal. Para crear o unirse a una llamada grupal, proporcione el chatInfo y meetingInfo. Si no se proporcionan, se crea automáticamente una nueva llamada de grupo. Para una llamada entrante, grabe estos valores en un almacén altamente disponible para que la aplicación pueda unirse a la llamada en caso de que la aplicación se bloquee.

Aunque la misma identidad no se puede invitar varias veces, es posible que una aplicación se una a la misma reunión varias veces. Cada vez que la aplicación desee unirse, se debe proporcionar una identidad diferente para que los clientes los muestren como participantes diferentes.

Nota: puede obtener la dirección URL de una reunión programada con Microsoft Teams. Extraer los datos de la dirección URL tal y como se muestran para rellenar chatInfo y 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

Se convierte en:

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

Methods

Método	Tipo de valor devuelto	Descripción
Obtener	call	Lee las propiedades del objeto llamada.
Eliminar	Ninguno	Elimina o cuelga una llamada activa.
KeepAlive	Ninguno	Asegúrese de que la llamada permanece activa.
Control de llamada
Respuesta	Ninguno	Responde a una llamada entrante.
Reject	Ninguno	Rechaza una llamada entrante.
Redirigir	Ninguno	Redirige una llamada entrante.
Transferir	Ninguno	Transferir una llamada
Llamadas de grupo
Enumerar participantes	Colección participant	Obtiene una colección de objetos participantes.
Invitar a participantes	commsOperation	Invita a participantes a la llamada activa.
Silenciar a todos los participantes	commsOperation	Silencia a todos los participantes de la llamada.
Silenciar participante	muteParticipantOperation	Silenciar a un participante en el grupo.
Crear audioRoutingGroup	audioRoutingGroup	Crea un nuevo audioRoutingGroup publicándolo en la colección audioRoutingGroups.
Enumerar audioRoutingGroups	Colección audioRoutingGroup	Obtiene una colección de objetos audioRoutingGroup.
Agregar una vista de galería grande	addLargeGalleryViewOperation	Agrega la vista de galería grande a una llamada.
Interactive-Voice-Response
PlayPrompt	playPromptOperation	Reproducir un mensaje en la llamada.
RecordResponse	recordOperation	Graba una respuesta corta de audio del autor de la llamada.
CancelMediaProcessing	commsOperation	Cancelar el proceso de medios.
SubscribeToTone	commsOperation	Suscribirse a tonos DTMF.
SendDtmfTones	commsOperation	Enviar tonos DTMF en una llamada.
Operaciones del propio participante
Mute	muteParticipantOperation	Silencia a uno mismo en la llamada.
Unmute	unmuteParticipantOperation	Se reactiva el audio de uno mismo en la llamada.
ChangeScreenSharingRole	Ninguno	Inicia y detiene el uso compartido de pantalla en la llamada
Operaciones de grabación
UpdateRecordingStatus	updateRecordingStatusOperation	Actualiza el estado de la grabación.
Operaciones de registro
Registrar datos de calidad del dispositivo	teleconferenceDeviceQuality	Registre datos de la calidad del dispositivo de teleconferencia de vídeo.

Propiedades

Propiedad	Tipo	Descripción
activeModalities	colección modality	La lista de modalidades activas. Los valores posibles son: `unknown`, `audio`, `video`, `videoBasedScreenSharing` y `data`. Solo lectura.
answeredBy	participantInfo	El participante que ha respondido a la llamada. Solo lectura.
callRoutes	Colección callRoute	Información de ruta sobre cómo se cambió el destino de la llamada. Solo lectura.
callbackUri	String	El identificador de la devolución de llamada de URL donde se entregarán las devoluciones de llamada. Debe ser `https`.
callChainId	Cadena	Un identificador único para todas las llamadas de participantes en una conferencia o un identificador único para llamadas de dos participantes en una llamada P2P. Se debe copiar desde `Microsoft.Graph.Call.CallChainId`.
callOptions	outgoingCallOptions	Contiene las características opcionales de la llamada.
chatInfo	chatInfo	La información del chat. Información necesaria para escenarios de reuniones.
direction	callDirection	La dirección de la llamada. Los valores posibles son `incoming` o `outgoing`. Solo lectura.
id	String	El identificador de llamada. Solo lectura.
incomingContext	incomingContext	Contexto asociado a una llamada entrante. Solo lectura. Generado por el servidor.
mediaConfig	appHostedMediaConfig o serviceHostedMediaConfig	La configuración de multimedia. Información necesaria para crear llamadas de punto a punto o unirse a reuniones.
mediaState	callMediaState	Solo lectura. El estado del medio de llamada.
meetingCapability	meetingCapability	Contiene las capacidades de una reunión. Solo lectura.
meetingInfo	organizerMeetingInfo, tokenMeetingInfo o joinMeetingIdMeetingInfo	La información de la reunión. Información necesaria para escenarios de reuniones.
transcripción	callTranscriptionInfo	La información de transcripción de la llamada. Solo lectura.
myParticipantId	Cadena	Solo lectura.
requestedModalities	colección modality	La lista de modalidades solicitadas. Los valores posibles son: `unknown`, `audio`, `video`, `videoBasedScreenSharing` y `data`.
resultInfo	resultInfo	La información del resultado. Por ejemplo, el resultado puede contener el motivo de terminación. Solo lectura.
ringingTimeoutInSeconds	Int32	Tiempo de espera de llamadas salientes de punto a punto El valor máximo para este atributo es 115 segundos.
routingPolicies	colección routingPolicy	Esta propiedad solo se aplica para las llamadas de igual a igual. Los valores posibles son: `none`, `noMissedCall`, `disableForwardingExceptPhone`, `disableForwarding`, `preferSkypeForBusiness`, `unknownFutureValue`.
source	participantInfo	El autor de la llamada.
state	callState	El estado de la llamada. Los valores posibles son: `incoming`, `establishing`, `ringing`, `established`, `hold`, `transferring`, `transferAccepted`, `redirecting`, `terminating` y `terminated`. Solo lectura.
subject	Cadena	El asunto de la conversación.
targets	invitationParticipantInfo colección	Los objetivos de la llamada. Información necesaria para crear una llamada de punto a punto.
tenantId	Cadena	Solo lectura. `tenantId`en Microsoft Entra ID.
terminationReason	Cadena	Solo lectura.
toneInfo	toneInfo	Solo lectura.

Relaciones

Relación	Tipo	Descripción
audioRoutingGroups	Colección audioRoutingGroup	Solo lectura. Admite valores NULL.
operations	Colección de commsOperation	Solo lectura. Admite un valor NULL.
participants	Colección participant	Solo lectura. Admite valores NULL.
contentSharingSessions	colección contentSharingSession	Solo lectura. Admite valores NULL.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "activeModalities": ["String"],
  "answeredBy": {"@odata.type": "#microsoft.graph.participantInfo"},
  "callRoutes": [{"@odata.type": "#microsoft.graph.callRoute"}],
  "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)",
  "incomingContext": {"@odata.type": "#microsoft.graph.incomingContext"},
  "mediaConfig": {"@odata.type": "#microsoft.graph.mediaConfig"},
  "mediaState": {"@odata.type": "#microsoft.graph.callMediaState"},
  "meetingCapability": {"@odata.type": "#microsoft.graph.meetingCapability"},
  "meetingInfo": {"@odata.type": "#microsoft.graph.meetingInfo"},
  "transcription": {"@odata.type": "#microsoft.graph.callTranscriptionInfo"},
  "myParticipantId": "String",
  "replacesContext": "String",
  "requestedModalities": ["String"],
  "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"},
  "ringingTimeoutInSeconds": 99,
  "routingPolicies": ["String"],
  "source": {"@odata.type": "#microsoft.graph.participantInfo"},
  "state": "String",
  "subject": "String",
  "targets": [{"@odata.type": "#microsoft.graph.invitationParticipantInfo"}],
  "tenantId": "String",
  "terminationReason": "String",
  "toneInfo": {"@odata.type": "#microsoft.graph.toneInfo"}
}