Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Meeting/ Referência de API do servidor/ Controle de reunião/ APIs/ Consulta de detalhes da reunião em tempo real

Atualizado em 2023-08-02 GMT+08:00

Ver PDF

Consulta de detalhes da reunião em tempo real

Descrição

Esta API é usada para consultar detalhes de reuniões em tempo real.

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

**Tabela 1** Protótipo
Método de solicitação	GET
Endereço de solicitação	/v1/mmc/control/conferences/realTimeInfo
Protocolo de transporte	HTTPS

Parâmetros de solicitação

**Tabela 2** Parâmetros
Parâmetro	Obrigatório	Tipo	Localização	Descrição
conferenceID	Sim	String	Consulta	ID da reunião.
X-Conference-Authorization	Sim	String	Cabeçalho	Token de controle de reunião, que é obtido através da API para obter um token de controle de reunião.

Códigos de status

**Tabela 3** Códigos de status
Código de status HTTP	Descrição
200	Operação bem-sucedida.
400	Parâmetros inválidos.
500	Exceção do servidor.

Parâmetros de resposta

**Tabela 4** Parâmetros de resposta
Parâmetro	Tipo	Descrição
attendees	Array of attendee objects	Informações sobre os participantes convidados durante o agendamento da reunião e participantes convidados pelo anfitrião durante a reunião. As informações sobre participantes on-line e ausentes são retornadas.
participants	Array of participant objects	Lista de participantes on-line, incluindo participantes que ingressaram na reunião, estão sendo chamados e estão ingressando na reunião.
confInfo	confInfo object	Detalhes da reunião.

**Tabela 5** Estrutura de dados attendee
Parâmetro	Tipo	Descrição
accountID	String	Conta do participante.
userUUID	String	UUID do participante.
name	String	Nome ou alias do participante. O valor pode conter até 96 caracteres.
phone	String	Número de inscrição do dispositivo do participante. (SIP e formatos de número de telefone são suportados.) O valor pode conter até 127 caracteres. Número da tela do meio quando o dispositivo é um dispositivo de telepresença de tela tripla.
phoneLeft	String	Número da tela esquerda quando o dispositivo é um dispositivo de telepresença de tela tripla. Este campo está reservado.
phoneRight	String	Número da tela direita quando o dispositivo é um dispositivo de telepresença de tela tripla. Este campo está reservado.

**Tabela 6** Estrutura de dados participant
Parâmetro	Tipo	Descrição
pid	String	ID do participante.
name	String	Nome ou alias do participante. O valor pode conter até 96 caracteres.
phone	String	Número de inscrição do dispositivo do participante. (Os formatos SIP e de número de telefone são suportados.) O valor pode conter até 127 caracteres.
state	Integer	Status do usuário. Os participantes que não ingressaram na reunião ou que deixaram a reunião não são exibidos na lista de participantes online. 0: o participante está na reunião. 1: o participante está sendo chamado. 2: o participante está ingressando na reunião.
video	Integer	Áudio ou vídeo. 0: áudio. 1: vídeo.
mute	Inteiro	Status do microfone. 0: ativado. 1: desativado.
hand	Integer	Status de levantar mão do participante. 0: o participante não levanta as mãos. 1: o participante levanta as mãos.

**Tabela 7** Estrutura de dados confInfo
Parâmetro	Tipo	Descrição
chairID	String	ID do anfitrião.

Exemplo de solicitação

GET /v1/mmc/control/conferences/realTimeInfo?conferenceID=914083136
Connection: keep-alive
X-Conference-Authorization:stbaf8fa2ea8a1b0e3ab2e007a85a75f88c55d5f6d5c1912dfb
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_131)

Exemplo de resposta

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 521
Connection: keep-alive
Server: api-gateway
http_proxy_id: b32bf70a8ac93ea13691fc34730fd78c

{
    "attendees": [
        {
            "accountID": "user01",
            "name": "user01",
            "phone": "+991116003815"
        }
    ],
    "participants": [
        {
            "pid": "a6b4e988216c11eabc516bc3a3d8d6c4",
            "name": "user01",
            "phone": "+991116003815",
            "state": 0,
            "video": 1,
            "mute": 1,
            "hand": 0
        }
    ],
    "confInfo": {}
}

Códigos de erro

Se um código de erro começando com MMC ou USG for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.

Exemplo de comando cURL

curl -k -i -X GET -H 'X-Conference-Authorization:stb39b3f21898d4972fed86b3f22ac70914a77303def15e126a' https://api.meeting.huaweicloud.com/v1/mmc/control/conferences/realTimeInfo?conferenceID=914083136

Tópico principal: APIs

Tópico anterior: Obtenção de um token de controle de reunião

Próximo tópico: Convide de participantes