Tipo de recurso call
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
chatInfoymeetingInfo.
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"}
Nota:
Los siguientes problemas conocidos están asociados a este recurso:
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Crear | call | Crear llamada permite al bot crear una nueva llamada de punto a punto o de grupo saliente, o unirse a una reunión existente. |
| Obtener | call | Lee las propiedades del objeto llamada. |
| Eliminar/colgar | Ninguno | Elimina o cuelga una llamada activa. |
| Mantenerse con vida | 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 | ||
| Lista | 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 | Crea un nuevo audioRoutingGroup publicándolo en la colección audioRoutingGroups. |
| Enumerar grupos de enrutamiento de audio | 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 | ||
| Reproducir un mensaje | playPromptOperation | Reproducir un mensaje en la llamada. |
| Respuesta de registro | recordOperation | Graba una respuesta corta de audio del autor de la llamada. |
| Cancelación del procesamiento multimedia | commsOperation | Cancelar el proceso de medios. |
| Suscribirse a tono | commsOperation | Suscribirse a tonos DTMF. |
| Enviar tono DTMF | commsOperation | Enviar tonos DTMF en una llamada. |
| Operaciones del propio participante | ||
| Silenciar aplicación | muteParticipantOperation | Silencia a uno mismo en la llamada. |
| Desenmute la aplicación | unmuteParticipantOperation | Se reactiva el audio de uno mismo en la llamada. |
| Cambiar la función de uso compartido de pantalla | Ninguno | Inicia y detiene el uso compartido de pantalla en la llamada |
| Operaciones de grabación | ||
| Actualización del estado de la grabación | updateRecordingStatusOperation | Actualiza el estado de la grabación. |
| Operaciones de registro | ||
| Datos de calidad del dispositivo de teleconferencia de registro | 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.
tenantIden 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",
"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"}
}