Tipo de recurso de chamada

  • Artigo

Namespace: microsoft.graph

O recurso de chamada é criado quando há uma chamada de entrada para o aplicativo ou o aplicativo cria uma nova chamada de saída por meio de um POST em communications/calls.

As chamadas podem ser configuradas como uma chamada ponto a ponto ou de grupo. Para criar ou ingressar em uma chamada de grupo, forneça o chatInfo e meetingInfo. Se esses valores não forem fornecidos, uma nova chamada de grupo será criada automaticamente. Para uma chamada de entrada, registre esses valores em um repositório altamente disponível para que seu aplicativo possa voltar à chamada se o aplicativo falhar.

Embora a mesma identidade não possa ser convidada várias vezes, é possível que um aplicativo participe da mesma reunião várias vezes. Sempre que o aplicativo quiser ingressar em uma chamada, uma identidade separada deve ser fornecida para que os clientes possam exibi-las como participantes diferentes.

Observação: você poderá obter a URL de ingresso em uma reunião agendada com o Microsoft Teams. Extraia os dados da URL conforme mostrado para preencher chatInfo e 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 tornará:

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 retorno Descrição
Get call Leia propriedades do objeto call.
Delete Nenhum Exclua ou desligue uma chamada ativa.
KeepAlive Nenhum Certifique-se de que a chamada permanece ativa.
Tratamento de chamadas
Resposta Nenhum Atenda às chamadas recebidas.
Reject Nenhum Rejeite as chamadas recebidas.
Redirecionar Nenhum Redirecione as chamadas recebidas.
Transfer Nenhum Transferir uma chamada
Chamadas de grupo
List participants participant collection Obtenha uma coleção do objeto participant.
Convidar participantes commsOperation Convide participantes para a chamada ativa.
Ativar mudo para participante muteParticipantOperation Ative o mudo para participante na chamada de grupo.
Create audioRoutingGroup audioRoutingGroup Crie um novo audioRoutingGroup postando na coleção audioRoutingGroups.
List audioRoutingGroups audioRoutingGroup collection Obtenha uma coleção de objetos audioRoutingGroup.
Adicionar exibição de galeria grande addLargeGalleryViewOperation Adicione o modo de exibição de galeria grande a uma chamada.
Resposta de voz interativa
PlayPrompt playPromptOperation Reproduza uma solicitação na chamada.
RecordResponse recordOperation Registra uma resposta de áudio curta do chamador.
CancelMediaProcessing commsOperation Cancele o processamento de mídia.
SubscribeToTone commsOperation Inscreva-se nos tons DTMF.
SendDtmfTones commsOperation Envie tons DTMF em uma chamada.
Operações de auto-participante
Mute muteParticipantOperation Ative o mudo para si mesmo na chamada.
Unmute unmuteParticipantOperation Desative o mudo automaticamente na chamada.
ChangeScreenSharingRole Nenhum Inicie e interrompa a tela de compartilhamento na chamada.
Operações de gravação
UpdateRecordingStatus updateRecordingStatusOperation Atualiza o status da gravação.
Operações de log
Registrar dados de qualidade do dispositivo teleconferenceDeviceQuality Registre dados de qualidade do dispositivo de videoconferência.

Propriedades

Propriedade Tipo Descrição
callbackUri String A URL de retorno de chamada na qual os retornos de chamada são entregues. Deve ser uma URL HTTPS.
callChainId Cadeia de caracteres Um identificador único para todas as chamadas de participantes em uma conferência ou um identificador exclusivo para chamadas com dois participantes em uma chamada P2P. Esse identificador deve ser copiado de Microsoft.Graph.Call.CallChainId.
callOptions outgoingCallOptions Contém os recursos opcionais para a chamada.
callRoutes callRoute collection As informações de roteamento sobre como a chamada foi redirecionada. Apenas leitura.
chatInfo chatInfo As informações de chat. Informações necessárias para ingressar em uma reunião.
direction callDirection A direção da chamada. Os valores possíveis são incoming ou outgoing. Somente leitura.
id Cadeia de caracteres O identificador exclusivo para a chamada. Apenas leitura.
incomingContext incomingContext O contexto associado a uma chamada recebida.
mediaConfig appHostedMediaConfig ou serviceHostedMediaConfig A configuração de mídia. Obrigatório.
mediaState callMediaState Somente leitura. O estado da mídia de chamadas.
meetingInfo organizerMeetingInfo, tokenMeetingInfo ou joinMeetingIdMeetingInfo As informações da reunião. Informações necessárias para cenários de reunião.
myParticipantId String Somente leitura.
requestedModalities coleção modality A lista de modalidades solicitadas. Os valores possíveis são: unknown, audio, video, videoBasedScreenSharing, data.
resultInfo resultInfo As informações de resultado. Por exemplo, o resultado pode conter o motivo da rescisão. Somente leitura.
source participantInfo O remetente da chamada.
state callState O estado da chamada. Os valores possíveis são: incoming, establishing, ringing, established, hold, transferring, transferAccepted, redirecting, terminating, terminated. Somente leitura.
assunto String O assunto da conversa.
targets conjunto invitationParticipantInfo O destinatário da chamada. Informações necessárias para criar chamadas ponto a ponto.
toneInfo toneInfo Somente leitura.
transcrição callTranscriptionInfo As informações da transcrição da chamada. Somente leitura.

Relações

Relação Tipo Descrição
contentSharingSessions coleção contentSharingSession Somente leitura. Anulável.
operations commsOperation collection Somente leitura. Anulável.
participantes participant collection Somente leitura. Anulável.

Representação JSON

A representação JSON a seguir mostra o 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"},
}