Compartilhar via


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 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.
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 estado da gravação updateRecordingStatusOperation Atualiza o status da gravação.
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. tenantId no 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"}
}