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.
Atualizado em 2023-08-02 GMT+08:00

Criação de uma reunião

Descrição

Esta API é usada para criar uma reunião instantânea ou agendar uma reunião.

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

POST

Endereço de solicitação

/v1/mmc/management/conferences

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

userUUID

Não

String

Consulta

UUID do usuário (registrado no USG).

X-Access-Token

Sim

String

Cabeçalho

Token de autorização. Use o valor de accessToken na resposta à solicitação de Autenticação de um ID de aplicação.

X-Authorization-Type

Não

String

Cabeçalho

Se a solicitação é enviada de um portal de terceiros.

X-Site-Id

Não

String

Cabeçalho

ID do site do HCS on-line onde a autenticação é realizada.

startTime

Não

String

Corpo

Hora UTC quando a reunião começa.

NOTA:
  • Se você não especificar esse parâmetro ao agendar uma reunião, a reunião será iniciada imediatamente.
  • O horário é o horário UTC±00:00.

Formato: aaaa-MM-dd HH:mm.

length

Não

Integer

Corpo

Duração da reunião, em minutos. Intervalo de valores: 15 até 1440. Valor padrão: 30.

subject

Não

String

Corpo

Tópico da reunião. O valor pode conter até 128 caracteres.

mediaTypes

Sim

String

Corpo

Tipo de mídia da reunião.

O valor consiste em um ou vários valores enumerados, que são separados por vírgulas (,). Os valores enumerados são os seguintes:

  • Voice: voz.
  • Video: vídeo SD.
  • HDVideo: vídeo HD (Este valor enumerado e Video são mutuamente exclusivos. Se ambos os valores forem especificados, o sistema usará Video).
  • Telepresence: telepresença (Este valor enumerado é mutuamente exclusivo com HDVideo e Video. Se todos os três valores forem especificados, o sistema usará Telepresence.) Este campo está reservado.
  • Data: multimídia (Este valor enumerado é determinado pela configuração do sistema.)

groupuri

Não

String

Corpo

ID de grupo temporário usado quando uma reunião instantânea é criada no cliente. Este parâmetro é transportado no cabeçalho conference-info ou quando outros participantes são convidados. O valor pode conter até 31 caracteres.

attendees

Não

Array of Attendee objects

Corpo

Lista de participantes, que pode ser usada para enviar notificações e lembretes de reuniões e ser usada pela Plataforma de gerenciamento do Huawei Cloud Meeting para convidar automaticamente participantes na hora de início da reunião.

cycleParams

Não

CycleParams object

Corpo

Lista de parâmetros de reuniões recorrentes, que é obrigatória para uma série de reuniões recorrentes.

A lista de parâmetros inclui a data de início, a data de término, o intervalo e a hora de início da série de reuniões recorrentes.

isAutoRecord

Não

Integer

Corpo

Se iniciar automaticamente a gravação para a reunião. Este parâmetro é válido somente quando recordType é definido como 2 ou 3. Valor padrão: 0.

  • 1: a gravação é iniciada automaticamente.
  • 0: a gravação não é iniciada automaticamente.

encryptMode

Não

Integer

Corpo

Modo de criptografia de mídia de reunião. O valor padrão é definido na configuração de nível empresarial.

  • 0: criptografia adaptativa.
  • 1: criptografia forçada.
  • 2: não criptografado.

language

Não

String

Corpo

Idioma padrão da reunião. O valor padrão é definido pelo servidor do Huawei Cloud Meeting.

Os idiomas suportados pela Plataforma de gerenciamento do Huawei Cloud Meeting são transmitidos conforme especificado no RFC 3066 comum.

  • zh-CN: chinês simplificado.
  • en-US: inglês (EUA).

timeZoneID

Não

String

Corpo

Fuso horário de reunião em notificações de reunião. Para obter detalhes, consulte Mapeamento de fuso horário.

NOTA:
  • Por exemplo, se timeZoneID estiver definido como 26, o horário na notificação de reunião enviada pelo Huawei Cloud Meeting é Tue, Nov 11, 2021 00:00 - 02:00 (GMT) Greenwich Mean Time:Dublin, Edinburgh, Lisbon, London.
  • Se a notificação de uma reunião não recorrente for enviada por um sistema de terceiros, deixe este parâmetro em branco.

recordType

Não

Integer

Corpo

Tipo de gravação. Valor padrão: 0.

  • 0: não gravando.
  • 1: transmissão ao vivo.
  • 2: gravando.
  • 3: transmissão ao vivo e gravando.

liveAddress

Não

String

Corpo

Endereço de transmissão ao vivo do vídeo. O valor pode conter até 255 caracteres. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

auxAddress

Não

String

Corpo

Endereço de transmissão ao vivo da apresentação. O valor pode conter até 255 caracteres. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

recordAuxStream

Não

Integer

Corpo

Se gravar a apresentação. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

  • 0: não grave a apresentação.
  • 1: grave a apresentação.

confConfigInfo

Não

ConfConfigInfo object

Corpo

Outras configurações de reunião.

recordAuthType

Não

Integer

Corpo

Modo de autenticação de gravação. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

  • 0: os usuários que obtiverem o link da gravação podem assistir ou baixar a gravação.
  • 1: somente usuários empresariais podem assistir ou baixar a gravação.
  • 2: somente os participantes da reunião podem visualizar e baixar a gravação.

vmrFlag

Não

Integer

Corpo

Se usar uma sala de reunião na nuvem ou ID de reunião pessoal para realizar a reunião agendada. Valor padrão: 0.

  • 0: não use nenhuma sala de reunião na nuvem.
  • 1: use uma sala de reunião na nuvem ou uma ID de reunião pessoal.

vmrID

Não

String

Corpo

ID da sala de reunião na nuvem vinculada à conta que cria a reunião. Obtenha o valor chamando a API para Consulta de salas de reunião em nuvem por página e o ID da reunião pessoal como um usuário comum.

NOTA:
  • Use o valor de id retornado pela API de consulta anterior, não o valor de vmrId.
  • Ao criar uma reunião usando um ID de reunião pessoal, defina vmrMode como 0. Ao criar uma reunião usando uma sala de reunião na nuvem, defina vmrMode como 1.

concurrentParticipants

Não

Integer

Corpo

Número máximo de participantes na reunião.

  • 0: ilimitado.
  • > 0
Tabela 3 Estrutura de dados Attendee

Parâmetro

Obrigatório

Tipo

Descrição

userUUID

Não

String

UUID do participante.

accountId

Não

String

ID da conta de um participante.

  • No cenário de autenticação de conta/senha, esse parâmetro é opcional. Use o ID de uma conta do Huawei Cloud Meeting.
  • No cenário de autenticação de ID de aplicação, esse parâmetro é obrigatório. Use o ID de um usuário de terceiros. O parâmetro appId deve ser carregado.

appId

Não

String

ID da aplicação. Você pode criar um ID da aplicação para uma aplicação apenas uma vez. Para obter detalhes, consulte Solicitação de um ID da aplicação.

No cenário de autenticação de ID de aplicação, esse parâmetro é obrigatório.

name

Não

String

Nome ou alias do participante. O valor pode conter até 96 caracteres.

role

Não

Integer

Papel de participante na reunião. Valor padrão: 0.

  • 0: participante comum.
  • 1: anfitrião da reunião.

phone

Não

String

  • No cenário de autenticação de conta/senha, esse parâmetro é obrigatório. O valor pode ser um número SIP ou um número de telefone. O valor pode conter até 127 caracteres. phone, email ou sms devem ser especificados.
  • No cenário de autenticação de ID da aplicação, esse parâmetro é opcional.

phone2

Não

String

Campo reservado. Os tipos de valor são os mesmos que os do parâmetro phone.

phone3

Não

String

Campo reservado. Os tipos de valor são os mesmos que os do parâmetro phone.

email

Não

String

Endereço de e-mail. O valor pode conter até 255 caracteres. No cenário de autenticação de conta/senha, phone, email ou sms devem ser especificados. (Esse parâmetro é usado para enviar notificações sobre agendamento, atualização e cancelamento de reuniões.)

sms

Não

String

Número de telemóvel para receber notificações por SMS. O valor pode conter até 32 caracteres. No cenário de autenticação de conta/senha, phone, email ou sms devem ser especificados. (Esse parâmetro é usado para enviar notificações sobre agendamento, atualização e cancelamento de reuniões.)

isMute

Não

Integer

Se deve silenciar automaticamente um participante quando o participante ingressar na reunião. Esse parâmetro é válido somente quando o participante é convidado para uma reunião em andamento. Valor padrão: 0.

  • 0: não silencie os participantes automaticamente.
  • 1: silencie os participantes automaticamente.

isAutoInvite

Não

Integer

Se convidar automaticamente os participantes quando a reunião começar. O valor padrão é definido na configuração de nível empresarial.

  • 0: não convide automaticamente os participantes.
  • 1: convide automaticamente os participantes.

type

Não

String

O valor padrão é definido pelo servidor do Huawei Cloud Meeting. Os valores enumerados são os seguintes:

  • normal: cliente suave.
  • telepresence: telepresença. Para telepresença de tela única e de tela tripla, use este valor. Este campo está reservado.
  • terminal: sala de reuniões ou terminal físico.
  • outside: participante externo.
  • mobile: número de celular.
  • telephone: número de telefone. Este campo está reservado.
  • ideahub: IdeaHub.

address

Não

String

Informações sobre a sala de reuniões onde um terminal está localizado. Este campo está reservado.

deptUUID

Não

String

ID do departamento. O valor pode conter até 64 caracteres.

deptName

Não

String

Nome do departamento. O valor pode conter até 128 caracteres.

Tabela 4 Estrutura de dados CycleParams

Parâmetro

Obrigatório

Tipo

Descrição

startDate

Sim

String

Data de início de uma série de reuniões recorrentes, no formato AAAA-MM-DD.

A data de início não pode ser anterior à data atual.

NOTA:

A data deve corresponder ao fuso horário especificado por timeZoneID. Não é a data do horário UTC.

endDate

Sim

String

Data final de uma série de reuniões recorrentes, no formato AAAA-MM-DD.

O intervalo entre a hora de início e a hora de término não pode exceder um ano. São permitidas até 50 reuniões entre a data de início e a data de término. Se houver mais de 50 reuniões, a Plataforma de gerenciamento do Huawei Cloud Meeting ajusta automaticamente a data de término.

NOTA:

A data deve corresponder ao fuso horário especificado por timeZoneID. Não é a data do horário UTC.

cycle

Sim

String

Tipo de período. As opções são as seguintes:

  • Day
  • Week
  • Month

interval

Não

Integer

  • Se cycle estiver definido como Day, a reunião recorrente será realizada em um intervalo de um número especificado de dias. O valor varia de 1 a 15.
  • Se cycle estiver definido como Week, a reunião recorrente será realizada em um intervalo de um número especificado de semanas. O valor varia de 1 a 5.
  • Se cycle estiver definido como Month, a reunião recorrente será realizada em um intervalo de um número especificado de meses. O valor varia de 1 a 3.

point

Não

Array of integers

Ponto para a realização da reunião recorrente. Este parâmetro só é válido quando cycle é definido como Week ou Month.

  • Se cycle estiver definido como Week e point estiver definido como 1 e 3, a reunião será realizada na segunda-feira e na quarta-feira. Se point for definido como 0, a reunião é realizada no domingo.
  • Se cycle estiver definido como Month e point estiver definido como 12 e 20, a reunião será realizada no décimo segundo e no vigésimo dia de cada mês. O valor do point varia de 1 a 31. Se o dia especificado não existir em um mês, a reunião é realizada no final do mês.

preRemindDays

Sim

Integer

Você pode especificar o número (N) de dias de antecedência para enviar uma notificação de reunião. O usuário que agenda a série de reuniões recebe uma notificação de todas as reuniões recorrentes. Todos os participantes recebem uma notificação de reunião (incluindo o calendário) N dias antes da hora de início de cada reunião recorrente.

O valor de N é ajustado automaticamente com base no interval. Se as reuniões recorrentes são realizadas a cada dois dias, o valor de N é alterado automaticamente para 2. Se as reuniões recorrentes forem realizadas na segunda e terça-feira a cada duas semanas, o valor de N é alterado automaticamente para 14. O horário de verão (DST) não é considerado.

O valor varia de 0 a 30.

Valor padrão: 1.

Tabela 5 Estrutura de dados Confconfiginfo

Parâmetro

Obrigatório

Tipo

Descrição

isSendNotify

Não

Boolean

Se enviar e-mails. O valor padrão é definido na configuração de nível empresarial.

  • true: envie e-mails.
  • false: não envie e-mails.

isSendSms

Não

Boolean

Se enviar notificações por SMS. O valor padrão é definido na configuração de nível empresarial.

  • true: envie notificações por SMS.
  • false: não envie notificações por SMS.
    NOTA:

    Somente empresas que usam edições comerciais podem enviar notificações por SMS. Para empresas gratuitas, as notificações por SMS não serão enviadas mesmo se isSendSms estiver definido como true.

isSendCalendar

Não

Boolean

Se enviar e-mails de calendário. O valor padrão é definido na configuração de nível empresarial.

  • true: envie e-mails de calendário.
  • false: não envie e-mails de calendário.

isAutoMute

Não

Boolean

Se deve silenciar o cliente suave de um convidado quando o convidado ingressar na reunião. O valor padrão é definido na configuração de nível empresarial.

  • true: silencie o convidado automaticamente.
  • false: não silencie o convidado automaticamente.

isHardTerminalAutoMute

Não

Boolean

Se deve silenciar o terminal físico de um convidado quando o convidado ingressar na reunião. O valor padrão é definido na configuração de nível empresarial.

  • true: silencie o convidado automaticamente.
  • false: não silencie o convidado automaticamente.

isGuestFreePwd

Não

Boolean

Se os convidados podem ingressar na reunião sem a senha de convidado. Esse parâmetro é válido somente para reuniões com IDs aleatórios.

  • true: os convidados podem ingressar na reunião sem a senha de convidado.
  • false: os convidados só podem participar da reunião usando a senha de convidado.

callInRestriction

Não

Integer

Participantes que podem participar da reunião.

  • 0: todos.
  • 2: usuários empresariais.
  • 3: usuários convidados.

allowGuestStartConf

Não

Boolean

Se permitir que os convidados iniciem a reunião. Esse parâmetro é válido somente para reuniões com IDs aleatórios.

  • true: os convidados podem iniciar a reunião.
  • false: os convidados não podem iniciar a reunião.

guestPwd

Não

String

Senha de convidado, que contém de 4 a 16 dígitos.

vmrIDType

Não

Integer

Tipo de ID da reunião da sala de reunião em nuvem.

  • 0: ID fixo.
  • 1: ID aleatório.

prolongLength

Não

Integer

Duração para estender automaticamente uma reunião. A faixa de valor recomendada é de 0 a 60.

0: a reunião termina automaticamente quando chega a hora final e não é estendida.

Outros valores: a reunião é prorrogada pela duração especificada.

NOTA:

A hora de término da reunião é calculada com base na duração da reunião. Por exemplo, uma reunião de duas horas começa às 9:00 e termina às 11:00. Se os participantes ingressarem na reunião às 8:00, a reunião terminará automaticamente às 10:00.

enableWaitingRoom

Não

Boolean

Se ativar ou não a sala de espera (válido apenas para empresas RTC).

  • true: ativar.
  • false: desativar.

Códigos de status

Tabela 6 Códigos de status

Código de status HTTP

Descrição

200

Operação bem-sucedida.

400

Parâmetros inválidos.

401

A autenticação não é executada ou falha.

403

Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 7 Parâmetros de resposta

Parâmetro

Tipo

Descrição

[Array element]

Array of ConferenceInfo

Informações da reunião.

Tabela 8 Estrutura de dados ConferenceInfo

Parâmetro

Tipo

Descrição

conferenceID

String

ID da reunião. O valor pode conter até 32 caracteres.

subject

String

Tópico da reunião. O valor pode conter até 128 caracteres.

size

Integer

Número de participantes na reunião.

timeZoneID

String

Fuso horário de reunião em notificações de reunião. Para obter detalhes, consulte Mapeamento de fuso horário.

NOTA:
  • Por exemplo, se timeZoneID estiver definido como 26, o horário na notificação de reunião enviada pelo Huawei Cloud Meeting é Tue, Nov 11, 2021 00:00 - 02:00 (GMT) Greenwich Mean Time:Dublin, Edinburgh, Lisbon, London.

startTime

String

Hora de início da reunião, no formato AAAA-MM-DD HH:MM.

endTime

String

Hora de término da reunião, no formato AAAA-MM-DD HH:MM.

mediaTypes

String

Tipo de mídia da reunião.

O valor consiste em um ou vários valores enumerados, que são separados por vírgulas (,). Os valores enumerados são os seguintes:

  • Voice: voz.
  • Video: vídeo SD.
  • HDVideo: vídeo HD (Este valor enumerado e Video são mutuamente exclusivos. Se ambos os valores forem especificados, a Plataforma de gerenciamento de reuniões do Huawei Cloud usa Video).
  • Telepresence: telepresença (Este valor enumerado é mutuamente exclusivo com HDVideo e Video. Se todos os três valores forem especificados, a Plataforma de gerenciamento do Huawei Cloud Meeting usa Telepresence. Este valor é reservado.)
  • Data: multimídia.

conferenceState

String

Estado da reunião. Atualmente, somente os estados Created e Schedule são retornados. Se a reunião estiver em andamento, o estado Created será retornado. Caso contrário, o estado Schedule será retornado.

  • Schedule: a reunião será realizada.
  • Creating: a reunião está sendo criada.
  • Created: a reunião foi criada e está em andamento.
  • Destroyed: a reunião terminou.

language

String

Linguagem de reunião.

accessNumber

String

Código de acesso da reunião.

passwordEntry

Array of PasswordEntry objects

Senhas de reunião. A palavra-passe do anfitrião e a palavra-passe do convidado são devolvidas ao utilizador que agenda a reunião.

  • Se o anfitrião consultar a senha, a senha do anfitrião será retornada.
  • Se um convidado consultar a senha, a senha do convidado será retornada.

userUUID

String

UUID do usuário que agenda a reunião.

scheduserName

String

Nome da conta do usuário que agenda a reunião. O valor pode conter até 96 caracteres.

conferenceType

Integer

  • 0: reunião ordinária.
  • 2: reunião recorrente.

confType

String

Tipo de reunião.

  • FUTURE
  • IMMEDIATELY
  • CYCLE

cycleParams

CycleParams object

Parâmetro de série de reuniões recorrentes. Esta lista de parâmetros é transportada quando a reunião é uma série de reuniões recorrentes.

A lista de parâmetros inclui a data de início, a data de término, o intervalo e a hora de início da série de reuniões recorrentes.

isAutoMute

Integer

Se deve silenciar os participantes automaticamente quando eles ingressam na reunião.

  • 0: não silencie os participantes automaticamente.
  • 1: silencie os participantes automaticamente.

isAutoRecord

Integer

Se ativar a gravação automaticamente.

  • 0: não ative a gravação automaticamente.
  • 1: ative a gravação automaticamente.

chairJoinUri

String

Link para o anfitrião ingressar na reunião.

guestJoinUri

String

Link para os convidados participarem da reunião. O valor pode conter até 1024 caracteres.

audienceJoinUri

String

URL do Webinar para os participantes participarem. O valor pode conter até 1024 caracteres.

recordType

Integer

Tipo de gravação.

  • 0: não gravando.
  • 1: transmissão ao vivo.
  • 2: gravando.
  • 3: transmissão ao vivo e gravando.

auxAddress

String

Endereço de transmissão ao vivo da apresentação.

liveAddress

String

Endereço de transmissão ao vivo do vídeo.

recordAuxStream

Integer

Se gravar a apresentação.

  • 0: não grave a apresentação.
  • 1: grave a apresentação.

recordAuthType

Integer

Modo de autenticação de gravação. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

  • 0: os usuários que obtiverem o link da gravação podem assistir ou baixar a gravação.
  • 1: somente usuários empresariais podem assistir ou baixar a gravação.
  • 2: somente os participantes da reunião podem visualizar e baixar a gravação.

liveUrl

String

Endereço de transmissão ao vivo. (Esse parâmetro é retornado quando uma sala de transmissão ao vivo é configurada.)

confConfigInfo

ConfConfigInfo object

Outras configurações de reunião.

vmrFlag

Integer

Se usar uma sala de reunião em nuvem para realizar a reunião agendada.

  • 0: não use nenhuma sala de reunião na nuvem.
  • 1: use uma sala de reunião em nuvem.

    O valor de vmrConferenceID é usado como a identificação da reunião indicada no GUI. O campo conferenceID ainda é usado para operações de serviço de reunião, como consultar detalhes de reunião, fazer logon no sistema de controle de reunião e ingressar rapidamente em uma reunião.

isHasRecordFile

Boolean

Se uma reunião histórica tem um arquivo de gravação. Valor padrão: false.

true: a reunião histórica tem um arquivo de gravação.

falso: a reunião histórica não tem um arquivo de gravação.

vmrConferenceID

String

Lista de salas de reunião na nuvem. Se vmrFlag for definido como 1, este parâmetro não pode estar vazio.

confUUID

String

UUID da reunião.

NOTA:
  • O UUID é retornado somente quando uma reunião instantânea é criada. Não será devolvido para uma reunião agendada.
  • Você pode obter o UUID de uma reunião histórica chamando a API para Consulta da lista de reuniões históricas.

partAttendeeInfo

Array of PartAttendee objects

Informações sobre os participantes convidados.

NOTA:

terminlCount

Integer

Número de terminais físicos, como IdeaHubs e TE30.

normalCount

Integer

Número de terminais comuns, como PCs e aplicações móveis.

deptName

String

Nome da empresa à qual pertence o usuário que agenda a reunião. O valor pode conter até 96 caracteres.

role

String

Papel do participante.

  • chair: anfitrião.
  • general: participante ou painelista.
  • audience: participante.
NOTA:
  • Esse parâmetro é retornado somente quando os detalhes da reunião são consultados.
  • O papel da pessoa que inicia a consulta é retornado.

multiStreamFlag

Integer

Se a reunião é uma reunião de vídeo multi-streaming.

  • 1: reunião de vídeo multi-streaming.

webinar

Boolean

Se a reunião é um webinar.

confMode

String

Tipo de reunião.

  • COMMON: reunião comum.
  • RTC: reunião RTC.

scheduleVmr

Boolean

Se a reunião é realizada em uma sala de reunião em nuvem.

  • True: sim.
  • False: não.

vmrID

String

Lista de salas de reunião na nuvem.

concurrentParticipants

Integer

Número máximo de participantes na reunião.

picDisplay

MultiPicDisplayDO object

Detalhes de presença contínua.

subConfs

Array of Subconfs objects

Lista de reuniões recorrentes.

cycleSubConfID

String

UUID da primeira reunião recorrente.

Tabela 9 Estrutura de dados PasswordEntry

Parâmetro

Tipo

Descrição

conferenceRole

String

Papel de participante na reunião.

  • chair: anfitrião da reunião.
  • general: participante comum.

password

String

Senha para uma função de participante, que está no modo de texto sem formatação.

Tabela 10 Estrutura de dados PartAttendee

Parâmetro

Tipo

Descrição

name

String

Nome ou alias do participante. O valor pode conter até 96 caracteres.

phone

String

Número de telefone. (Os formatos SIP e de número de telefone são suportados.) O valor pode conter até 127 caracteres. phone, email ou sms devem ser especificados.

NOTA:

Se type estiver definido como telepresence e o dispositivo usado para ingressar na reunião for uma telepresença de tela tripla, defina esse parâmetro como o número da tela do meio. (Este campo é reservado para telepresença de tela tripla.)

phone2

String

Os tipos de valor são os mesmos que os do parâmetro phone. Este campo está reservado.

NOTA:

Se type estiver definido para telepresence e o dispositivo usado para ingressar na reunião for uma telepresença de tela tripla, defina esse parâmetro para o número da tela esquerda.

phone3

String

Os tipos de valor são os mesmos que os do parâmetro phone. Este campo está reservado.

NOTA:

Se type estiver definido para telepresence e o dispositivo usado para ingressar na reunião for uma telepresença de tela tripla, defina esse parâmetro para o número de tela correto.

type

String

O valor padrão é definido pelo servidor do Huawei Cloud Meeting. Os valores enumerados são os seguintes:

  • normal: cliente suave.
  • telepresence: telepresença. Para telepresença de tela única e de tela tripla, use este valor. Este campo está reservado.
  • terminal: sala de reuniões ou terminal físico.
  • outside: participante externo.
  • mobile: número de celular.
  • telephone: número de telefone. Este campo está reservado.

role

Integer

Papel de participante na reunião. Valor padrão: 0.

  • 0: participante comum.
  • 1: anfitrião da reunião.

isMute

Integer

Se deve silenciar automaticamente um participante quando o participante ingressar na reunião. Esse parâmetro é válido somente quando o participante é convidado para uma reunião em andamento. Valor padrão: 0.

  • 0: não silencie os participantes automaticamente.
  • 1: silencie os participantes automaticamente.
Tabela 11 Estrutura de dados MultiPicDisplayDO

Parâmetro

Tipo

Descrição

manualSet

Integer

Se a presença contínua é personalizada.

  • 0: não.
  • 1: sim.

imageType

String

Tipo de layout. Opções:

  • Single: tela única.
  • Two: duas telas.
  • Three: três telas. Three-2: três telas-2. Three-3: três telas-3. Three-4: três telas-4.
  • Four: quatro telas. Four-2: quatro telas-2. Four-3: quatro telas-3.
  • Five: cinco telas. Five-2: cinco telas-2.
  • Six: seis telas. Six-2: seis telas-2. Six-3: seis telas-3. Six-4: seis telas-4. Six-5: seis telas-5.
  • Seven: sete telas. Seven-2: sete telas-2. Seven-3: sete telas-3. Seven-4: sete telas-4.
  • Eight: oito telas. Eight-2: oito telas-2. Eight-3: oito telas-3. Eight-4: oito telas-4.
  • Nine: nove telas.
  • Ten: dez telas. Ten-2: dez telas-2. Ten-3: dez telas-3. Ten-4: dez telas-4. Ten-5: dez telas-5. Ten-6: dez telas-6.
  • Thirteen: treze telas. Thirteen-2: treze telas-2. Thirteen-3: treze telas-3. Thirteen-4: treze telas-4. Thirteen-5: treze telas-5. ThirteenR: treze telas-R. ThirteenM: treze telas-M.
  • Sixteen: dezesseis telas.
  • Seventeen: dezessete telas.
  • Twenty-Five: vinte e cinco telas.
  • Custom: presença contínua personalizada

subscriberInPics

Array of PicInfoNotify objects

Lista de telas.

switchTime

String

Intervalo para exibir os participantes por sua vez, em segundos. Esse parâmetro é válido somente quando uma tela contém várias fontes de vídeo.

picLayoutInfo

PicLayoutInfo object

Detalhes sobre o layout personalizado de presença contínua.

Tabela 12 Estrutura de dados PicInfoNotify

Parâmetro

Tipo

Descrição

index

Integer

Número de cada tela em presença contínua. O número começa a partir de 1.

id

Array of strings

ID de sessão de cada tela (callNumber).

share

Integer

Se a apresentação é usada. Opções:

  • 0: não.
  • 1: sim.
Tabela 13 Estrutura de dados PicLayoutInfo

Parâmetro

Tipo

Descrição

x

Integer

Número de telas horizontais.

y

Integer

Número de telas verticais.

subPicLayoutInfoList

Array of SubPicLayoutInfo objects

Configurações de presença contínua.

Tabela 14 Estrutura de dados SubPicLayoutInfo

Parâmetro

Tipo

Descrição

id

Integer

Índice da tela.

left

Integer

Índice da tela da esquerda para a direita.

top

Integer

Índice da tela de cima para baixo.

xSize

Integer

Tamanho horizontal da tela.

ySize

Integer

Tamanho vertical da tela.

Tabela 15 Estrutura de dados CycleParams

Parâmetro

Tipo

Descrição

startDate

String

Data de início de uma série de reuniões recorrentes, no formato AAAA-MM-DD.

A data de início não pode ser anterior à data atual.

endDate

String

Data final de uma série de reuniões recorrentes, no formato AAAA-MM-DD.

O intervalo entre a hora de início e a hora de término não pode exceder um ano. São permitidas até 50 reuniões entre a data de início e a data de término. Se houver mais de 50 reuniões, a Plataforma de gerenciamento do Huawei Cloud Meeting ajusta automaticamente a data de término.

cycle

String

Tipo de período. As opções são as seguintes:

  • Day
  • Week
  • Month

interval

Integer

  • Se cycle estiver definido como Day, a reunião recorrente será realizada em um intervalo de um número especificado de dias. O valor varia de 1 a 15.
  • Se cycle estiver definido como Week, a reunião recorrente será realizada em um intervalo de um número especificado de semanas. O valor varia de 1 a 5.
  • Se cycle estiver definido como Month, a reunião recorrente será realizada em um intervalo de um número especificado de meses. O valor varia de 1 a 3.

point

Array of integers

Ponto para a realização da reunião recorrente. Este parâmetro só é válido quando cycle é definido como Week ou Month.

  • Se cycle estiver definido como Week e point estiver definido como 1 e 3, a reunião será realizada na segunda-feira e na quarta-feira. Se point for definido como 0, a reunião é realizada no domingo.
  • Se cycle estiver definido como Month e point estiver definido como 12 e 20, a reunião será realizada no décimo segundo e no vigésimo dia de cada mês. O valor do point varia de 1 a 31. Se o dia especificado não existir em um mês, a reunião é realizada no final do mês.

preRemindDays

Integer

Você pode especificar o número (N) de dias de antecedência para enviar uma notificação de reunião. O usuário que agenda a série de reuniões recebe uma notificação de todas as reuniões recorrentes. Todos os participantes recebem uma notificação de reunião (incluindo o calendário) N dias antes da hora de início de cada reunião recorrente.

O valor de N é ajustado automaticamente com base no interval. Se as reuniões recorrentes são realizadas a cada dois dias, o valor de N é alterado automaticamente para 2. Se as reuniões recorrentes forem realizadas na segunda e terça-feira a cada duas semanas, o valor de N é alterado automaticamente para 14. O horário de verão (DST) não é considerado.

O valor varia de 0 a 30.

Valor padrão: 1.

Tabela 16 Estrutura de dados ConfConfigInfo

Parâmetro

Tipo

Descrição

isSendNotify

Boolean

Se enviar e-mails. O valor padrão é definido na configuração de nível empresarial.

  • true: envie e-mails.
  • false: não envie e-mails.

isSendSms

Boolean

Se enviar notificações por SMS. O valor padrão é definido na configuração de nível empresarial.

  • true: envie notificações por SMS.
  • false: não envie notificações por SMS.

isSendCalendar

Boolean

Se enviar e-mails de calendário. O valor padrão é definido na configuração de nível empresarial.

  • true: envie e-mails de calendário.
  • false: não envie e-mails de calendário.

isAutoMute

Boolean

Se deve silenciar o cliente suave de um convidado quando o convidado ingressar na reunião. O valor padrão é definido na configuração de nível empresarial.

  • true: silencie o convidado automaticamente.
  • false: não silencie o convidado automaticamente.

isHardTerminalAutoMute

Boolean

Se deve silenciar o terminal físico de um convidado quando o convidado ingressar na reunião. O valor padrão é definido na configuração de nível empresarial.

  • true: silencie o convidado automaticamente.
  • false: não silencie o convidado automaticamente.

isGuestFreePwd

Boolean

Se os convidados podem ingressar na reunião sem a senha de convidado. Esse parâmetro é válido somente para reuniões com IDs aleatórios.

  • true: os convidados podem ingressar na reunião sem a senha de convidado.
  • false: os convidados só podem participar da reunião usando a senha de convidado.

callInRestriction

Integer

Participantes que podem participar da reunião.

  • 0: todos.
  • 2: usuários empresariais.
  • 3: usuários convidados.

allowGuestStartConf

Boolean

Se permitir que os convidados iniciem a reunião. Esse parâmetro é válido somente para reuniões com IDs aleatórios.

  • true: os convidados podem iniciar a reunião.
  • false: os convidados não podem iniciar a reunião.

guestPwd

String

Senha de convidado, que contém de 4 a 16 dígitos.

vmrIDType

Integer

Tipo de ID da reunião da sala de reunião em nuvem.

  • 0: ID fixo.
  • 1: ID aleatório.

prolongLength

Integer

Duração para estender automaticamente uma reunião. A faixa de valor recomendada é de 0 a 60.

0: a reunião termina automaticamente quando chega a hora final e não é estendida.

Outros valores: a reunião é prorrogada pela duração especificada.

enableWaitingRoom

Boolean

Ativar ou não a sala de espera (válido apenas para empresas RTC).

  • true: ativar.
  • false: desativar.

Exemplo de solicitação

POST /v1/mmc/management/conferences
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
Content-Type: application/json
user-agent: WeLink-desktop
Content-Length: 548
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "mediaTypes": "Video,Voice",
    "startTime": "",
    "length": 120,
    "attendees": [
        {
            "accountId": "user01",
            "name": "user01",
            "role": "0",
            "phone": "+991116003815",
            "isMute": "1"
        }
    ],
    "subject": "user01's meeting"
}

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: 1153
Connection: keep-alive
http_proxy_id: 79ea4d8bdb461a4b811a117f9cf3dbde
Server: api-gateway
X-Request-Id: 1ccc1d7937dd0f66067aeecb9f1df241

[
    {
        "conferenceID": "914083136",
        "mediaTypes": "Voice,Data,Video",
        "subject": "user01's meeting",
        "size": 1,
        "timeZoneID": "56",
        "startTime": "2019-12-18 07:28",
        "endTime": "2019-12-18 09:28",
        "conferenceState": "Created",
        "accessNumber": "+991117",
        "language": "zh-CN",
        "passwordEntry": [
            {
                "conferenceRole": "chair",
                "password": "157599"
            },
            {
                "conferenceRole": "general",
                "password": "582397"
            }
        ],
        "userUUID": "ff808081699b56cb0169be103500012b",
        "scheduserName": "user8002",
        "conferenceType": 0,
        "confType": "IMMEDIATELY",
        "isAutoMute": 1,
        "isAutoRecord": 0,
        "chairJoinUri": "https://c.meeting.huaweicloud.com/#/j/914083136/6a30b8b5a325105da031442627828e496f91021ece36405f",
        "guestJoinUri": "https://c.meeting.huaweicloud.com/#/j/914083136/9505dc3349228b1ce0db8165590cc977bcff89785130fe0d",
        "recordType": 0,
        "recordAuxStream": 0,
        "confConfigInfo": {  
            "isSendNotify": true,
            "isSendSms": true,
            "isAutoMute": true
        },
        "vmrFlag": 0,
        "isHasRecordFile": false,
        "partAttendeeInfo": [
            {
                "phone": "+991116003815",
                "name": "user01",               
                "type": "normal"
            }
        ],
        "terminlCount": 0,
        "normalCount": 1,
        "deptName": "wangyue",
        "confUUID": "050c7898216811eaa6958bf3bb9ac167"
    }
]

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 -H 'content-type: application/json' -X POST -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d '{"conferenceType": "0","subject": "user01 conference","mediaTypes": "HDVideo","attendees": [{"name": "user01","role": 1,"phone": "+8657*******"}]}' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences'