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 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 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.
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.
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"},
}