Tipo de recurso de chamada
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
O recurso de chamada é criado quando existe uma chamada a receber para a aplicação ou a aplicação cria uma nova chamada efetuada através de um POST no app/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 chatInfo e meetingInfo. Se estas não forem fornecidas, é criada automaticamente uma nova chamada de grupo. Para uma chamada recebida, grave esses valores em um armazenamento altamente disponível para que o aplicativo reingresse na chamada caso enfrente uma falha.
Embora a mesma identidade não possa ser convidada várias vezes, é possível que uma aplicação participe na mesma reunião várias vezes. Sempre que o aplicativo quiser ingressar, uma identidade separada deve ser fornecida para que os clientes possam exibi-las como 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
chatInfoemeetingInfo.
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"}
Observação
Os seguintes problemas conhecidos estão associados a este recurso:
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Criar | chamada | Criar chamada permite que o bot crie uma nova chamada ponto a ponto ou de grupo ou participe numa reunião existente. |
| Get | call | Leia propriedades do objeto call. |
| Excluir/desligar | Nenhum | Exclua ou desligue uma chamada ativa. |
| Mantenha-se vivo | 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 em Grupo | ||
| List | participant collection | Obtenha uma coleção do objeto participant. |
| Convidar participantes | commsOperation | Convide participantes para a chamada ativa. |
| Ativar mudo para todos os participantes | commsOperation | Ative o mudo para todos os participantes em uma chamada. |
| Ativar mudo para participante | muteParticipantOperation | Ative o mudo para participante na chamada de grupo. |
| Create | audioRoutingGroup | Crie um novo audioRoutingGroup postando na coleção audioRoutingGroups. |
| Listar grupos de encaminhamento de áudio | 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. |
| Interactive-Voice-Response | ||
| Reproduzir prompt | playPromptOperation | Reproduza uma solicitação na chamada. |
| Resposta de registo | recordOperation | Registra uma resposta de áudio curta do chamador. |
| Cancelar o processamento de multimédia | commsOperation | Cancele o processamento de mídia. |
| Assinar ao sinal | commsOperation | Inscreva-se nos tons DTMF. |
| Enviar tom DTMF | commsOperation | Enviar tons DTMF numa chamada. |
| Operações do próprio participante | ||
| Desativar som da aplicação | muteParticipantOperation | Ative o mudo para si mesmo na chamada. |
| Ativar o som da aplicação | unmuteParticipantOperation | Desative o mudo automaticamente na chamada. |
| Alterar função de compartilhamento de tela | Nenhum | Inicie e interrompa a tela de compartilhamento na chamada. |
| Operações de gravação | ||
| Atualizar status de gravação | updateRecordingStatusOperation | Atualiza o status da gravação. |
| Iniciar gravação | startRecordingOperation | Inicia a gravação de uma chamada. |
| Parar gravação | stopRecordingOperation | Interrompe a gravação de uma chamada. |
| Iniciar transcrição | startTranscriptionOperation | Inicia a transcrição de uma chamada. |
| Parar transcrição | stopTranscriptionOperation | Interrompe a transcrição de uma chamada. |
| Operações de Registro | ||
| Dados de qualidade do dispositivo de teleconferência de registo | teleconferenceDeviceQuality | Registre dados de qualidade do dispositivo de videoconferência. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| activeModalities | coleção modality | A lista de modalidades ativas. Os valores possíveis são: unknown, audio, video, videoBasedScreenSharing, data. Somente leitura. |
| answeredBy | participantInfo | O participante que atendeu a chamada. Somente leitura. |
| callRoutes | callRoute collection | As informações de roteamento sobre como a chamada foi redirecionada. Somente leitura. |
| callbackUri | String | A URL de retorno de chamada à qual os retornos serão entregues. Deve ser 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. Isso precisa ser copiado de Microsoft.Graph.Call.CallChainId. |
| callOptions | outgoingCallOptions | Contém os recursos opcionais para a chamada. |
| chatInfo | chatInfo | As informações de chat. Informações necessárias para cenários de reunião. |
| direction | callDirection | A direção da chamada. Os valores possíveis são incoming ou outgoing. Somente leitura. |
| id | String | A ID de chamada. Somente leitura. |
| incomingContext | incomingContext | O contexto associado a uma chamada recebida. Somente leitura. Servidor gerado. |
| mediaConfig | appHostedMediaConfig ou serviceHostedMediaConfig | A configuração de mídia. As informações necessárias para a criação de chamadas ponto a ponto ou para entrar em reuniões. |
| mediaState | callMediaState | Somente leitura. O estado da mídia de chamadas. |
| meetingCapability | meetingCapability | Contém os recursos de uma reunião. Somente leitura. |
| meetingInfo | organizerMeetingInfo, tokenMeetingInfo ou joinMeetingIdMeetingInfo | As informações da reunião. Informações necessárias para cenários de reunião. |
| transcrição | callTranscriptionInfo | As informações da transcrição da chamada. Somente leitura. |
| 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 terminação. Somente leitura. |
| ringingTimeoutInSeconds | Int32 | Tempo limite do toque em segundos para chamadas realizadas de ponto a ponto. O valor máximo para esse atributo é de 115 segundos. |
| routingPolicies | routingPolicy collection (coleção routingPolicy) | Essa propriedade é aplicável somente às chamadas ponto a ponto. Os possíveis valores são: none, noMissedCall, disableForwardingExceptPhone, disableForwarding, preferSkypeForBusiness, unknownFutureValue. |
| 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. |
| tenantId | String | Somente leitura.
tenantIdem Microsoft Entra ID. |
| terminationReason | String | Somente leitura. |
| toneInfo | toneInfo | Somente leitura. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| audioRoutingGroups | audioRoutingGroup collection | Somente leitura. Anulável. |
| operations | commsOperation collection | Somente leitura. Anulável. |
| participantes | participant collection | Somente leitura. Anulável. |
| contentSharingSessions | coleção contentSharingSession | Somente leitura. Anulável. |
Representação JSON
A representação JSON seguinte mostra o 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"}
}