Tipo de recurso call

  • Artículo

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 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 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
Enumerar participantes 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 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 de participantes automáticos
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 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",  
  "replacesContext": "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"},
}