Todos os produtos
Search
Central de documentação

Cloud Phone:Melhores práticas para integração do Cloud Phone

Última atualização: Jun 28, 2026

Este tópico descreve a solução de integração e as melhores práticas para integrar o Alibaba Cloud Workspace Cloud Phone.

Solução de integração

A figura a seguir ilustra a solução de integração do Alibaba Cloud Workspace Cloud Phone:

image
  • O servidor do Alibaba Cloud Workspace oferece recursos essenciais, como gerenciamento de instâncias, conexões, chaves e aplicativos, permitindo a integração com seus sistemas de servidor e cliente.

  • Seu servidor integra a API do Cloud Phone para ative o agendamento de instâncias e a autenticação de usuários.

  • Seu cliente integra os SDKs do Cloud Phone para Android e Windows. Após a autenticação do usuário, o cliente utiliza o Adaptive Streaming Protocol (ASP) para acessar os cloud phones por meio dos gateways de tráfego do Alibaba Cloud Workspace.

Melhores práticas para integração no lado do servidor

Durante a integração no lado do servidor, agende instâncias, autentique usuários e exponha APIs para acesso dos clientes. A seção a seguir detalha as melhores práticas para essa integração.

Modelo de negócios

O Alibaba Cloud Workspace Cloud Phone introduz o conceito de grupos de instâncias, que permite crie vários cloud phones em um único grupo. No entanto, recomenda-se manter uma proporção de 1:1 entre grupos de instâncias e cloud phones. Ou seja, crie apenas um cloud phone por grupo de instâncias para simplificar operações como alterações de imagem.

O Alibaba Cloud Workspace Cloud Phone também oferece suporte ao Cloud Phone Matrix. É possível crie várias instâncias de cloud phone em uma matriz.

Agendamento de instâncias

Gerencie os cloud phones associados à sua conta Alibaba Cloud, incluindo as seguintes tarefas:

  • Criação de instâncias: Crie cloud phones conforme a necessidade. Realize essa tarefa manualmente no console do Cloud Phone ou chame a operação CreateAndroidInstanceGroup.

  • Destruição de instâncias: Exclua os cloud phones quando não forem mais necessários. Execute essa ação manualmente no console do Cloud Phone ou chame a operação DeleteAndroidInstanceGroup.

  • Manutenção do pool de instâncias:

    • Quando um cliente iniciar uma solicitação de conexão, atribua um cloud phone ocioso do pool e marque-o como "Used".

    • Ao desconectar o cliente do cloud phone, retorne o dispositivo ao estado "Idle". Chame a operação RunCommand para exclua arquivos relevantes, se necessário, e garantir que não restem vestígios de uso.

  • Monitoramento do status do pool de instâncias: Monitore o uso do pool de instâncias. Caso atinja um limiar, como 80%, acione alertas e escale o pool dinâmica ou manualmente.

  • Melhoria na velocidade de agendamento: Garanta conexões rápidas antecipando a concorrência máxima do negócio e mantendo cloud phones disponíveis suficientes para agendamento.

Integração do sistema de contas e conexão de logon

O Alibaba Cloud Workspace Cloud Phone oferece suporte aos seguintes métodos de logon:

  • Logon sem autorização (modo baseado em ticket): Este modo permite que usuários finais temporários se conectem aos cloud phones sem necessidade de autorização prévia. Apenas os cloud phones criados após a ativação do logon sem autorização suportam este método. Para implementá-lo, o servidor da parte integradora chama a operação BatchGetAcpConnectionTicket para gerar um ticket com base em um ID de usuário exclusivo e no ID do cloud phone. Passe esse ticket ao SDK do lado do cliente para estabelecer a conexão com o cloud phone de destino.

    image
  • Logon sem autorização (modo AuthCode): Com o logon sem autorização ativado, qualquer string exclusiva que represente um ID de usuário pode obter um AuthCode. Ao passar o AuthCode para o SDK do lado do cliente, os usuários finais conseguem se conectar a qualquer cloud phone associado à conta Alibaba Cloud atual. O AuthCode torna-se inválido após um único uso. Para reconectar, obtenha um novo AuthCode.

    image

Como o logon sem autorização oferece maior flexibilidade e elimina a necessidade de manter relações de mapeamento entre contas de negócios e contas de conveniência, recomendamos adotar essa abordagem ao integrar o Cloud Phone ao seu sistema corporativo.

Nota

Para ative o logon sem autorização, envie um ticket e forneça o UID da sua conta Alibaba Cloud.

  • Logon com conta de conveniência: Este modo garante o acesso confiável de usuários aos cloud phones utilizando o sistema de contas do Elastic Desktop Service (EDS) e a autorização de acesso ao cloud phone. Primeiro, crie uma conta de conveniência no sistema de contas do EDS. Em seguida, atribua cloud phones à conta autorizada. Após concluir a atribuição, os usuários finais poderão se conectar a qualquer cloud phone vinculado a essa conta de conveniência por meio da página de baixe do cliente Alibaba Cloud Workspace. Se os usuários finais desejarem se conectar aos cloud phones via SDK do lado do cliente usando uma conta de conveniência, chame a operação GetLoginToken para recuperar as credenciais de logon, incluindo o token de logon e o ID da sessão, e passe essas credenciais para o SDK do lado do cliente.

    image

Autorização de usuário e conexão ao cloud phone (logon sem autorização baseado em ticket)

A autenticação de usuário faz parte do processo de integração no lado do servidor. Para permitir que usuários se conectem aos cloud phones, seu backend deve executar as etapas a seguir para gerar um ticket de acesso.

A conexão ao cloud phone integra o processo do lado do cliente. Estabeleça a conexão passando o ticket para o cliente.

image
  • Consultar cloud phones: O servidor chama a operação DescribeAndroidInstances para recuperar informações detalhadas das instâncias e obter o ID (AndroidInstanceId) do cloud phone desejado.

  • Obter um ticket: Prepare previamente um ID de usuário final (EndUserId), que pode ser qualquer string exclusiva. Em seguida, chame a operação BatchGetAcpConnectionTicket utilizando o AndroidInstanceId e o EndUserId para recuperar o ticket de conexão.

  • Inicializar uma sessão: No exemplo do cliente web, inicialize a sessão chamando wuyingSdk.createSession().

  • Estabelecer uma conexão: Ainda no exemplo do cliente web, chame session.start() para estabelecer a conexão com a sessão.

  • Desconectar: No exemplo do cliente web, chame session.stop() para encerrar a conexão com a sessão.

Referências

Para mais informações sobre como se conectar aos cloud phones a partir de diferentes clientes, consulte os seguintes tópicos: