Tipo de recurso de chamada
Namespace: microsoft.graph
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 communications/calls.
As chamadas podem ser configuradas como uma chamada ponto a ponto ou de grupo. Para criar ou aderir a uma chamada de grupo, forneça e chatInfomeetingInfo. Se estes valores não forem fornecidos, é criada automaticamente uma nova chamada de grupo. Para uma chamada recebida, registe estes valores num arquivo de elevada disponibilidade para que a sua aplicação possa voltar a participar na chamada se a aplicação falhar.
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 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
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 de grupo | ||
| List | 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 | 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 de participantes autónomos | ||
| 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. |
| Operações de registo | ||
| 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 |
|---|---|---|
| callbackUri | String | O URL de chamada de retorno no qual as chamadas de retorno são entregues. Tem de ser um 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. Este identificador tem de 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 da 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 terminaçã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 seguinte 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",
"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"},
}