Tipo de recurso de chamada
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
emeetingInfo
.
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"},
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de