Tipo de recurso call
Espacio de nombres: microsoft.graph
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 POSTcommunications/calls.
Las llamadas pueden configurarse como de punto a punto o como llamada grupal. Para crear o unirse a una llamada de grupo, proporcione y chatInfomeetingInfo. Si no se proporcionan estos valores, se crea automáticamente una nueva llamada de grupo. Para una llamada entrante, registre estos valores en un almacén de alta disponibilidad para que la aplicación pueda volver a unir la llamada si la aplicación se bloquea.
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 llamadas | ||
| 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 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 de participantes automáticos | ||
| 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 | Description |
|---|---|---|
| callbackUri | Cadena | Dirección URL de devolución de llamada en la que se entregan las devoluciones de llamada. Debe ser una dirección URL 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. Este identificador debe copiarse de Microsoft.Graph.Call.CallChainId. |
| callOptions | outgoingCallOptions | Contiene las características opcionales de la llamada. |
| callRoutes | Colección callRoute | Información de ruta sobre cómo se cambió el destino de la llamada. Solo lectura. |
| chatInfo | chatInfo | La información del chat. Información necesaria para unirse a una reunión. |
| direction | callDirection | La dirección de la llamada. Los valores posibles son incoming o outgoing. Solo lectura. |
| id | Cadena | Identificador único de la llamada. Solo lectura. |
| incomingContext | incomingContext | Contexto de llamada asociado a una llamada entrante. |
| mediaConfig | appHostedMediaConfig o serviceHostedMediaConfig | La configuración de multimedia. Obligatorio. |
| mediaState | callMediaState | Solo lectura. El estado del medio de llamada. |
| meetingInfo | organizerMeetingInfo, tokenMeetingInfo o joinMeetingIdMeetingInfo | La información de la reunión. Información necesaria para escenarios de reuniones. |
| 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. |
| 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. |
| toneInfo | toneInfo | Solo lectura. |
| transcripción | callTranscriptionInfo | La información de transcripción de la llamada. Solo lectura. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| contentSharingSessions | colección contentSharingSession | 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. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"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",
"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"},
}