Todos los productos
Search
Centro de documentos

Cloud Phone:Web SDK

Última actualización: Oct 15, 2026

El Web SDK de Alibaba Cloud Workspace proporciona API abiertas para conectar el Workspace Web Client con Elastic Desktop Service (EDS), las aplicaciones en la nube y los teléfonos en la nube. Al integrar el SDK, usted puede personalizar y compilar rápidamente un cliente web adaptado a sus necesidades empresariales.

1. Inicio rápido

1.1 SDK y demostración

Nota

Al descargar y usar el SDK, usted acepta la Política de privacidad del SDK de Alibaba Cloud Workspace.

No los distribuya a terceros sin el consentimiento de Alibaba Cloud.

Estructura de directorios

├── WuyingWebDemo.html  // A sample page demonstrating SDK usage.
├── WuyingWebSDK.js     // The SDK API file. You must reference this file in your frontend page.
└── sdk                 // Resource files for iframe embedding.
     └── ASP
          └── container.html
  • Web.SDK.Demo es un proyecto de Vue. Para iniciar el proyecto:

    1. Compruebe si Node.js está instalado:

      node
      • Si aparece el mensaje Welcome to Node.js, significa que Node.js ya está instalado.

      • Si no ve este mensaje, instale Node.js.

    2. Vaya al directorio raíz del proyecto de Vue:

      Nota

      Reemplace <ProjectRootPath> con la ruta al directorio raíz del proyecto de Vue.

      cd <ProjectRootPath>
    3. Instale las dependencias:

      npm i
    4. Inicie el proyecto:

      npm run dev

      Si la operación se completa correctamente, se devuelve una URL accesible.

  • Para iniciar WuyingWebDemo.html:

    1. Vaya al directorio donde se encuentra el archivo HTML:

      Nota

      Reemplace <HTMLPath> con la ruta al directorio del archivo HTML.

      cd <HTMLPath>
    2. Inicie el servidor HTTP:

      python3 -m http.server
    3. En su navegador, abra http://localhost:8000/WuyingWebDemo.html.

1.2 Flujo de integración

image

1.3 Mejores prácticas

Consulte Best practices for quick integration of cloud phones. La siguiente figura muestra la arquitectura de integración.

image

Existen varios métodos de inicio de sesión para obtener el ticket que requiere el SDK y conectarse a un teléfono en la nube. El siguiente diagrama de flujo ilustra este proceso.

image

Para ver el código específico, consulte los ejemplos de código de las API del ciclo de vida.

2. API del ciclo de vida

2.1 Inicializar y crear una sesión

// Create a session using a ticket.
var userInfo = {
  ticket: 'xxx',
};
var appInfo = {
  osType: 'Android', // Required
  appId: "android", 
  appInstanceId: "ai-xxxxxx", // The appInstanceId starts with ai-.
  productType: "AndroidCloud",
  connectionProperties: JSON.stringify({ authMode: "Session" }) ,
};
var sessionParam = {
  openType: openType,
  iframeId: 'sessionIframe',
  resourceType: "local",
  connectType: 'app',
  userInfo: userInfo,
  appInfo: appInfo,
};
var wuyingSdk = Wuying.WebSDK;
session = wuyingSdk.createSession('appstream', sessionParam);
// Create a session using an authCode.
var userInfo = {
  authCode: authCode,
};
var appInfo = {
  osType: 'Android', // Required
  appId: "android", 
  resourceId: "p-xxxxxx", // The resourceId starts with p-.
  productType: "AndroidCloud",
  connectionProperties: JSON.stringify({ authMode: "Session" }) ,
};
var sessionParam = {
  openType: openType,
  iframeId: 'sessionIframe',
  resourceType: "local",
  connectType: 'app',
  userInfo: userInfo,
  appInfo: appInfo,
};
var wuyingSdk = Wuying.WebSDK;
session = wuyingSdk.createSession('appstream', sessionParam);
// Create a session using a loginToken or stsToken.
var userInfo = {
  sessionId: sessionId,
  loginToken: loginToken,
};
var appInfo = {
  osType: 'Android', // Required
  appId: "android", 
  resourceId: "p-xxxxxx", // The resourceId starts with p-.
  productType: "AndroidCloud",
  connectionProperties: JSON.stringify({ authMode: "Session" }) ,
};
var sessionParam = {
  openType: openType,
  iframeId: 'sessionIframe',
  resourceType: "local",
  connectType: 'app',
  userInfo: userInfo,
  appInfo: appInfo,
};
var wuyingSdk = Wuying.WebSDK;
session = wuyingSdk.createSession('appstream', sessionParam);

Parámetros de createSession

Parámetro

Tipo

Obligatorio

Descripción

id

string

Sí

Establezca este valor con la constante appstream para Cloud Phone.

sessionParams

SessionParam

Sí

Los parámetros para crear una sesión. Consulte 4.1 SessionParam.

Parámetros de sessionParams

  • userInfo:

    • sessionId: el SessionId que devuelve la operación GetLoginToken o GetStsToken.

    • authCode: el código de autorización que se obtiene al llamar a la API GetAuthCode.

    • loginToken: el token de inicio de sesión que se obtiene al llamar a la API GetLoginToken.

Nota

Existen dos métodos de inicio de sesión: sin autorización y con una cuenta de conveniencia. El inicio de sesión con cuenta de conveniencia depende del sistema de usuarios de Alibaba Cloud Workspace, mientras que el método sin autorización le permite usar su propio sistema de usuarios. El parámetro de autenticación para el inicio de sesión sin autorización es authCode, y para el inicio de sesión con cuenta de conveniencia es loginToken. El ticket es la credencial para conectarse a una instancia. Tanto loginToken como authCode se convierten finalmente en un ticket para establecer la conexión con la instancia. Debe especificar uno de los siguientes parámetros: authCode, ticket o loginToken.

  • appInfo: información sobre la instancia.

    • resourceId:

      • Si inicia sesión con una cuenta de conveniencia, llame a la operación DescribeUserResources desde el cliente para obtener el valor de ResourceId.

      • Si inicia sesión sin autorización, llame a la operación DescribeAndroidInstances desde su servidor para obtener el valor de PersistentAppInstanceId.

    • openType: define cómo se abre el teléfono en la nube. Consulte la enumeración openType en este documento.

2.2 Establecer una conexión

session.start();

2.3 Finalizar una conexión

session.stop();

2.4 Funciones de devolución de llamada

API: addHandle(name: SessionEventType, callback: Function)

Parámetros:

Parámetro

Tipo

Descripción

name

string

El tipo de evento que se va a escuchar. Consulte 5.9 SessionEventType.

callback

Function

La función de devolución de llamada.

Ejemplo:

session.addHandle('getConnectionTicketInfo', (data) => {
  console.log(data);
});

session.addHandle('onConnected', (data) => {
  console.log('connected', data);
});

session.addHandle('onDisConnected', (data) => {
  console.log('disconnect', data);
});

session.addHandle('onRuntimeMsg', (data) => {
  document.getElementById('GuestMsgContext').value = JSON.stringify(data);
});

3. API

API

Descripción

WebSDK.apiVersion

Devuelve el número de versión de WebSDK como un valor de tipo string.

setInputEnabled(param: boolean)

enableInput(param: boolean)

Habilita o deshabilita la entrada de datos.

  • Cuando esta opción está deshabilitada, el teléfono en la nube no responde a los eventos de entrada del teclado, ratón o panel táctil local.

  • enableInput y setInputEnabled cumplen la misma función. Se recomienda usar setInputEnabled.

enableKeyBoard(param: boolean)

Habilita o deshabilita el teclado en pantalla del teléfono en la nube.

setClipboardEnabled(param: boolean)

Habilita o deshabilita el portapapeles.

setMicrophoneEnabled(param: boolean)

Habilita o deshabilita el micrófono.

setTouchEnabled(param: boolean)

Habilita o deshabilita la entrada táctil.

setUiParams(param: UiConfig)

Establece la configuración de la interfaz de usuario después de crear una sesión. Por ejemplo, permite mostrar u ocultar el menú y forzar el modo horizontal.

Nota

Consulte 4.4 UiConfig.

Ejemplo:

var uiConfig = {
  toolbar: {
    visible: false,
  },
  rotateDegree: 90,
};
session.setUiParams(uiConfig);

dataChannel

Un canal de datos personalizado para enviar y recibir información entre el cliente y la nube.

// Configure dataChannelConfig in sessionParam.
dataChannelConfig: [{
     dataChannelName: 'wy_vdagent_default_dc',
}
// Listen for messages on the data channel.
/** The string `value` specifies the rotation: "0" for 0°, "1" for 90°, "2" for 180°, and "3" for 270°.
  * The message format for rotation is {"action":"rotation","value":"0"}.
*/
session.addDataChannelListener('wy_vdagent_default_dc', 'data', data => console.log('data from wy_vdagent_default_dc', data));
// Send a message through the data channel.
// Parameters: channel name, message content
session.sendDataChannelMessage('wy_vdagent_default_dc', new Uint8Array([1, 2, 3, 4]));

lyncChannel

Un canal para que el cliente envíe comandos ADB.

// Configure lyncChannelConfig in sessionParam.
lyncChannelConfig: [
{
    lyncChannelName: 'lync_adb_shell',
}
// Send an ADB command.
session.value.sendLyncMessage(
    'lync_adb_shell',
    JSON.stringify({
      id: Date.now(), // A unique ID for the command.
       cmd: OperationMap[type],
     }),
 );
// Listen for the ADB command response.
session.addLyncListener('lync_adb_shell', 'onReceivedLyncData', data => console.log('data from lync_adb_shell', data));

4. Parámetros

4.1 SessionParam

Parámetros para crear una sesión.

Parámetro

Tipo

Obligatorio

Descripción

openType

OpenType

Sí

Indica si la página se abre en un iframe incrustado o en una pestaña nueva.

iframeId

string

No

Obligatorio si la página se abre en un iframe.

sdkPath

string

No

La ruta al archivo del SDK. Si se deja vacío, se usa la ruta relativa predeterminada. Ejemplo: ./ASP/container.html.

resourceType

ResourceType

Sí

El tipo de recurso. Actualmente, solo se admiten páginas de conexión local.

connectType

ConnectType

Sí

Indica si la conexión es hacia un teléfono en la nube o hacia una computadora en la nube.

isOverseas

boolean

No

Indica si el acceso proviene de una ubicación en el extranjero. Valor predeterminado: false.

userInfo

UserInfo

Sí

La información de autenticación del usuario.

regionId

string

Sí

Obligatorio al conectarse a un teléfono en la nube. Es la región donde se encuentra el teléfono en la nube.

appInfo

AppInfo

No

Información sobre la aplicación que se iniciará en el teléfono en la nube.

fileInfo

FileInfo

No

Parámetros de la unidad en la nube.

uiConfig

UiConfig

No

Configuración de la interfaz de usuario para la página de conexión.

logDisabled

bool

No

Indica si se deshabilitan las estadísticas de ARMS. Valor predeterminado: false (habilitadas).

loginType

LoginType

No

El método de inicio de sesión. Valor predeterminado: cuenta de Alibaba Cloud Workspace.

networkAccessType

string

No

El tipo de acceso a la red, como el inicio de sesión mediante VPC. Valor predeterminado: vacío.

4.2 UserInfo

Contiene la información de autenticación del usuario. Elija uno de los siguientes parámetros: authCode, ticket o loginToken. El valor de authCode se obtiene de un flujo de inicio de sesión preautorizado, mientras que loginToken proviene de un inicio de sesión con cuenta de conveniencia. Usted puede obtener un ticket mediante una solicitud que incluya un authCode o un loginToken.

Parámetro

Tipo

Obligatorio

Descripción

authCode

string

Sí

Una credencial de inicio de sesión de un solo uso. Este parámetro tiene la prioridad más alta.

ticket

string

Sí

A partir de la versión 1.4.7, usted puede usar un ticket para conectarse directamente.

loginToken

string

Sí

La credencial de autenticación para una cuenta de conveniencia.

sessionId

string

Sí

El identificador de sesión que se obtiene de una solicitud GetLoginToken o GetStsToken.

4.3 AppInfo

Parámetros para iniciar un teléfono en la nube.

Parámetro

Tipo

Obligatorio

Descripción

osType

string

Sí

Debe establecerse como Android.

appId

string

Sí

El identificador persistente de la instancia de la aplicación (PersistentAppInstanceId). Ejemplo: p-0caoet4e18cui****.

appVersion

string

No

La versión de la aplicación que se va a iniciar.

loginRegionId

string

Sí

La región donde se encuentran los recursos del teléfono en la nube.

connConfig

ConnConfig

No

Los parámetros de configuración de la conexión.

appInstanceGroupId

string

No

El identificador del grupo de entrega.

appInstanceId

string

No

El identificador de la instancia. Es obligatorio cuando se establece una conexión con un ticket. Ejemplo: ai-0cc7s3n1iagyq****.

taskId

string

No

El identificador de la tarea de inicio de la aplicación.

bizRegionId

string

No

La región donde se encuentran los recursos de la aplicación.

productType

string

No

El tipo de grupo de entrega. Para los teléfonos en la nube, este valor debe ser AndroidCloud.

4.4 UiConfig

Configuración de la interfaz de usuario para la página de conexión.

Parámetro

Tipo

Obligatorio

Descripción

toolbar

ToolBarConfig

No

Configuración de visualización de la barra de herramientas.

exitCheck

bool

No

Indica si se muestra un aviso de confirmación cuando el usuario sale de la página. Valor predeterminado: habilitado.

rotateDegree

number

No

Fuerza el modo horizontal (0: normal; 90: forzar modo horizontal).

vconsoleVisiable

bool

No

Indica si se muestra el cuadro de depuración de vConsole.

debugPanelVisiable

bool

No

Indica si se muestra el panel de depuración con métricas como la tasa de bits y la velocidad de fotogramas.

reconnectType

ReconnectType

No

El estilo del cuadro de diálogo de aviso de reconexión.

defaultResolution

ResolutionType

No

La resolución predeterminada para la conexión inicial. Valor predeterminado: A.

language

Language

No

El idioma de los avisos internos. Valor predeterminado: chino simplificado.

allowErrorDialog

bool

No

Indica si se muestran los cuadros de diálogo de error.

backgroundColor

string

No

Color de fondo personalizado para la pantalla de carga.

backgroundImg

string

No

Imagen de fondo personalizada para la pantalla de carga.

4.5 ToolBarConfig

Configuración de visualización de la barra de herramientas.

Parámetro

Tipo

Obligatorio

Descripción

visible

bool

No

Indica si se muestra la barra de herramientas.

noMenu

bool

No

Indica si DesktopAssistant puede abrir el menú contextual. Valor predeterminado: false. Compatible con la versión 1.4.20 y posteriores.

4.6 ConnConfig

Parámetros de configuración de la conexión.

Parámetro

Tipo

Obligatorio

Descripción

decodeType

ConnDecodeType (enumeración numérica)

No

El método de decodificación.

playSoundBackground

bool

No

Indica si el sonido continúa reproduciéndose cuando la aplicación se ejecuta en segundo plano.

5. Tipos de enumeración

5.1 Tipo de apertura

Define cómo se abre la sesión del teléfono en la nube.

Valor

Descripción

newTab

Abre la sesión en una pestaña nueva del navegador.

inline

Abre la sesión en un iframe incrustado.

urlScheme

Inicia la sesión mediante el cliente local. Requiere el cliente de Alibaba Cloud Workspace versión 6.2 o posterior.

5.2 Tipo de conexión

Indica si se inicia una computadora en la nube o un teléfono en la nube.

Valor

Descripción

app

Inicia un teléfono en la nube.

desktop

Inicia una computadora en la nube.

El servicio Cloud Phone utiliza actualmente el tipo app. Cuando se conecta a un teléfono en la nube, el parámetro connectType queda fijo en app.

5.3 Tipo de recurso

Indica si se abre la página de conexión local o el cliente web de Alibaba Cloud Workspace.

Valor

Descripción

local

Abre la página HTML de conexión local.

La integración de Cloud Phone utiliza el valor codificado local.

5.4 Tipo de reconexión

El estilo de la interfaz de usuario para el aviso de reconexión.

Valor

Descripción

simple

Un indicador de carga sencillo.

normal

Un cuadro de diálogo con un temporizador de cuenta regresiva.

5.5 Tipo de resolución

La resolución predeterminada para la conexión inicial. La configuración del usuario anula este valor predeterminado.

Valor

Descripción

A

Prioriza la velocidad. Utiliza el tamaño actual de la ventana.

B

Prioriza la calidad. Utiliza el tamaño actual de la ventana multiplicado por window.devicePixelRatio.

5.6 Tipo de cobro

El método de facturación del teléfono en la nube.

Valor

Descripción

Compatible desde

PostPaid

pay-as-you-go

1.4.0

PrePaid

suscripción

1.4.0

5.7 Idioma

La configuración de idioma. Valor predeterminado: zh-CN.

Valor

Descripción

zh-CN

Chino simplificado

en-US

Inglés

ja-JP

Japonés

5.8 Tipo de inicio de sesión

El método para iniciar sesión en el teléfono en la nube.

Valor

Descripción

aliyunLogin

Inicia sesión con una cuenta de Alibaba Cloud.

normalLogin

Inicio de sesión con una cuenta de Alibaba Cloud Workspace (Cloud Phone solo admite normalLogin).

5.9 Tipo de evento de sesión

Tipos de eventos de una sesión, incluidos los eventos específicos de los teléfonos en la nube.

Valor

Descripción

Compatible desde

getConnectionTicketInfo

Se activa cuando se inicia una conexión con un teléfono en la nube.

1.0.0

onConnected

Se activa cuando se establece una conexión con un teléfono en la nube.

1.0.0

onDisConnected

Se activa cuando finaliza la conexión con el teléfono en la nube.

1.0.0

onRuntimeMsg

Un mensaje enviado desde el entorno de ejecución al SDK.

1.1.0

networkData

Métricas de rendimiento de la red.

1.3.1

onError

Se activa cuando ocurre un error durante la conexión.

1.4.1

5.10 Tipo de decodificación de conexión

El tipo de decodificación para la transmisión.

Valor

Descripción

Compatible desde

0

Decodificación por software

1.2.0

1

Decodificación por hardware

1.2.0

2

WebRTC

1.2.0

5.11 Tipo de protocolo

El tipo de protocolo.

Valor

Descripción

Compatible desde

ASP

Protocolo ASP desarrollado internamente por Alibaba Cloud. Los teléfonos en la nube solo admiten este protocolo.

1.3.0

HDX

Protocolo de Citrix

1.3.0

Códigos de error

Errores de onDisconnected

Código

Parámetro

Descripción

0

ASP_CLIENT_DISCONNECT_CONNECT_ERROR

Desconectado.

1

ASP_CLIENT_DISCONNECT_SOCKET_CLOSE

El socket se cerró.

2

ASP_CLIENT_DISCONNECT_WEBRTC_CLOSE

WebRTC se cerró.

25

La verificación del ticket falló. Este error también ocurre si intenta reutilizar el ticket de una sesión desconectada para establecer una nueva conexión.

1206

Un ticket solo admite una conexión simultánea. Este error ocurre si intenta iniciar una nueva conexión mientras el teléfono en la nube ya está conectado.

1207

Al reiniciar la instancia, el ticket deja de ser válido.

2000

ASP_CLIENT_DISCONNECT_OK

El teléfono en la nube se desconectó de forma normal.

2001

ASP_CLIENT_DISCONNECT_CLOUD_APP_STOP

La aplicación en la nube se cerró.

2002

ASP_CLIENT_DISCONNECT_CLIENT_PREEMPTION

La sesión actual del teléfono en la nube fue interrumpida por otra conexión.

2003

ASP_CLIENT_DISCONNECT_GUEST_SHUTDOWN_REBOOT

El sistema invitado se reinició.

2004

El usuario actual se desconectó.

2027

El modo de extracción de flujo cambió.

2200

ASP_CLIENT_RTT_TIMEOUT

Se agotó el tiempo de espera de RTT.

2201

ASP_CLIENT_NET_ERROR_IO

Error de E/S de red.

2202

ASP_CLIENT_UPDATE_TICKET_FAILED

No se pudo actualizar el ticket.

Errores de onError

Formato: {code: string, message: string, api: string}. El parámetro message contiene el valor de requestId, y el parámetro api indica la solicitud que generó el error.

Código

Descripción

AccountNotAvailable

La cuenta de dominio está bloqueada, deshabilitada o caducada. Póngase en contacto con su administrador de TI o con el administrador del controlador de dominio para resolverlo.

ClientLockedForAliasFailed

Alcanzó el número máximo de intentos incorrectos. Vuelva a intentarlo en 5 minutos.

content-monthpackageenterpostpaidphase

El paquete de suscripción de este teléfono en la nube se agotó durante el ciclo de facturación actual. El uso posterior se cobrará bajo el modelo pay-as-you-go.

content-recordingscreen

Su administrador de TI habilitó la grabación de pantalla y la auditoría para su teléfono en la nube, por lo que se registrarán todas las operaciones. Si tiene dudas sobre esta función, comuníquese con su administrador.

desktop-AgentUnbinding

No se pudo conectar al nuevo teléfono en la nube temporal porque aún se está desvinculando el anterior. Intente conectarse de nuevo más tarde.

desktop-AssignUserFailed

No se pudo asignar el teléfono en la nube. Inténtelo de nuevo más tarde.

desktop-ConnectTicket.Timeout

La conexión con el teléfono en la nube falló por un tiempo de espera agotado. Reinicie el teléfono en la nube e intente conectarse de nuevo.

desktop-DesktopAgentFileLose

La conexión falló porque falta un archivo de proceso principal del teléfono en la nube. Reinicie el teléfono en la nube y vuelva a conectarse. Si el problema persiste, comuníquese con su administrador de TI.

desktop-DesktopContainSecuritySoftware

El software de seguridad instalado en el teléfono en la nube interrumpe su conexión con el servicio de administración. Solicite a su administrador de TI que deshabilite dicho software y luego intente conectarse de nuevo.

desktop-DesktopContainVpn

El software de VPN instalado en el teléfono en la nube interrumpe su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-DesktopGuestStop

La conexión falló porque el teléfono en la nube no se encuentra en estado "Running".

desktop-DesktopNetworkAnomaly

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-DesktopNetworkError

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-DesktopResourceStatusInvalid

La conexión con el teléfono en la nube falló porque la instancia ECS subyacente no se encuentra en estado "Running". Reinicie el teléfono en la nube e intente conectarse de nuevo.

desktop-DesktopResourceStop

La conexión con el teléfono en la nube falló porque la instancia ECS subyacente está detenida. Reinicie el teléfono en la nube e intente conectarse de nuevo.

desktop-DesktopsUnderMaintenance

La conexión falló porque el teléfono en la nube no se encuentra en estado "Running".

desktop-DesktopUnavailable

La conexión falló. Inténtelo de nuevo más tarde. Si el problema persiste, solicite a su administrador de TI que compruebe el estado del teléfono en la nube.

desktop-DistributeLockFailed

La conexión falló porque demasiados usuarios intentan conectarse a teléfonos en la nube temporales. Intente conectarse de nuevo más tarde.

desktop-GENERAL_ERROR

Ocurrió un error en el servicio. Intente conectarse de nuevo al teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

desktop-GET_TICKET_LOCK

Las solicitudes de conexión al teléfono en la nube son demasiado frecuentes. Inténtelo de nuevo más tarde.

desktop-INSUFFICIENT_QUOTA

No hay ningún teléfono en la nube temporal disponible porque la cuota de la cuenta del administrador de TI es insuficiente. Solicite ayuda a su administrador de TI.

desktop-INTERNAL_ERROR

Ocurrió un error en el servicio. Intente conectarse de nuevo al teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

desktop-InvalidBundleId.NotFound

La plantilla de imagen de este teléfono en la nube no es válida. Comuníquese con su administrador de TI.

desktop-InvalidClientIp.Policy

No puede conectarse desde su dirección IP actual porque su administrador de TI configuró una lista blanca de direcciones IP para este teléfono en la nube. Solicite ayuda a su administrador de TI.

desktop-InvalidClientType.AccessDenied

Su administrador de TI prohibió ejecutar este teléfono en la nube en el cliente actual. Para usarlo, comuníquese con su administrador de TI.

desktop-InvalidDesktopId.NotFound

Su administrador de TI revocó su permiso para usar este teléfono en la nube.

desktop-InvalidDesktopId.Status

La conexión falló porque el teléfono en la nube no se encuentra en estado "Running".

desktop-InvalidDesktopStatus.NotRunning

El teléfono en la nube no se apagó debido a un error del servidor. Inténtelo de nuevo más tarde o comuníquese con su administrador de TI.

desktop-InvalidDesktopStatus.NotStopped

El teléfono en la nube no se inició debido a un error del servidor. Inténtelo de nuevo más tarde o comuníquese con su administrador de TI.

desktop-InvalidDesktopStatusInvalid

La conexión falló porque el teléfono en la nube no se encuentra en estado "Running".

desktop-InvalidLiteConnectionCheck

El teléfono en la nube no se reconectó debido a un error en el servicio de protocolo. Intente conectarse de nuevo.

desktop-NoEnoughDesktops

No se pueden asignar teléfonos en la nube temporales debido a la configuración de su administrador de TI. Comuníquese con él.

desktop-NotFindDesktopId

El administrador de TI liberó este teléfono en la nube.

desktop-NotFoundUserDesktop

Su administrador de TI revocó su permiso para usar este teléfono en la nube.

desktop-PermissionDeny.Desktop

Su administrador de TI revocó sus permisos. Para seguir usando el teléfono en la nube, solicítele que los restablezca.

desktop-RES_GW_ERROR

Ocurrió un error en el servicio. Intente conectarse de nuevo al teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

desktop-SDK.ReadTimeout

Ocurrió un error en el servicio. Intente conectarse de nuevo al teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

desktop-ServiceUnavailable

Se agotó el tiempo de espera de la conexión con el servicio. Intente conectarse de nuevo al teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

desktop-THROTTLING_USER

Ocurrió un error en el servicio. Intente conectarse de nuevo al teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

desktop-UnavailableDesktop

Se agotó el tiempo de espera para iniciar sesión en el teléfono en la nube. Vuelva a conectarse o reinicie el teléfono en la nube para resolver este problema. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-UnavailableDesktop.2901

La conexión con el teléfono en la nube falló porque el servicio de protocolo no pudo conectarse al entorno en la nube. Reinicie el teléfono en la nube para resolver este problema. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-UnavailableDesktop.2902

La conexión con el teléfono en la nube falló porque el servicio de protocolo no responde. Reinicie el teléfono en la nube para resolver este problema. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-UnavailableDesktop.2903

La conexión con el teléfono en la nube falló debido a un problema en el entorno en la nube. Reinicie el teléfono en la nube para resolverlo. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-UnavailableDesktop.2904

La conexión con el teléfono en la nube falló debido a un problema en el entorno en la nube. Reinicie el teléfono en la nube para resolverlo. Si la conexión sigue fallando, comuníquese con su administrador de TI.

desktop-UnavailableDesktop.2905

La conexión falló porque se agotó el tiempo de espera al cerrar la sesión de otro usuario en este teléfono en la nube compartido. Vuelva a conectarse o reinicie el teléfono en la nube.

desktop-UnavailableDesktop.2906

La conexión falló porque se agotó el tiempo de respuesta durante el inicio de sesión en el sistema. Vuelva a conectarse o reinicie el teléfono en la nube.

desktop-UnavailableDesktop.2907

La conexión con el teléfono en la nube falló porque el servicio de protocolo aún se está iniciando. Intente conectarse de nuevo más tarde o reinicie el teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

desktop-UnavailableDesktop.NotRegistered

El administrador de TI eliminó este teléfono en la nube.

desktop-UnavailableDesktop.ServerNotReady

La conexión falló debido a un error durante el inicio de sesión en el sistema. Solicite a su administrador de TI que restablezca sus permisos para usar el teléfono en la nube.

desktop.linux-UnavailableDesktop.AuthFailed

Es posible que la conexión con el teléfono en la nube haya fallado porque la instancia ya no está unida al dominio. Reinicie el teléfono en la nube e intente conectarse de nuevo, o bien comuníquese con su administrador de TI.

DesktopNetworkError.AbortBySoftware

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.BadHandShake

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.BindAddressFailed

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.ConnectAddressFailed

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.ConnectionClosedError

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.ConnectionRefusedError

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.ConnectionResetError

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.ConnectionTimeout

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.DnsLookupFailed

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.Forbidden

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.ReceivedUnexpectedEOF

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.SystemOutOfResource

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopNetworkError.UnKnowError

Un problema de red en el teléfono en la nube interrumpió su conexión con el servicio de administración. Reinicie el teléfono en la nube para resolver este problema.

DesktopStatus-Desc-Updating

Este teléfono en la nube no está disponible temporalmente mientras se modifica su configuración.

DesktopStatus-Repairing

En reparación.

DesktopStatus-Updating

Actualizando la configuración.

DeviceNotInManage

No se pudo iniciar sesión. La autenticación de dispositivos de confianza está habilitada para la red de oficina o la organización. Solicite al administrador que deshabilite esta autenticación o que agregue manualmente el terminal actual como dispositivo de confianza.

DirectoryLoginUnsupported

La información que introdujo es incorrecta. Use su identificador de organización para iniciar sesión.

DomainFailed

La conexión con el teléfono en la nube falló porque no se pudo unir el sistema a un dominio.

DomainRelationshipFailed

La conexión con el teléfono en la nube falló debido a un problema con la relación de confianza de dominio del sistema.

ExistedEmail

La dirección de correo electrónico ya está en uso. Introduzca una diferente.

ExistedEndUserId

El nombre de usuario ya está en uso. Introduzca uno diferente.

ExistedPhoneNumber

El número de celular ya está en uso. Introduzca uno diferente.

ExpiredEmailVerifyCode

El código de verificación por correo electrónico caducó. Solicite uno nuevo.

FailedToSendEmailVerifyCode

No se pudo enviar el código de verificación por correo electrónico. Inténtelo de nuevo.

ForbidByClientVersionForBusiness

Este identificador de organización corresponde a una edición empresarial. Debe actualizar el cliente a la versión más reciente para iniciar sesión.

ForbidByPasswordPolicy

No se pudo cambiar la contraseña. Su administrador de TI deshabilitó la función "Change logon password".

FOTA_DESKTOP_IN_USE

El teléfono en la nube "%s" está en uso. Desconéctese de él y luego intente actualizar de nuevo.

FOTA_SNAPSHOT_IN_PROGRESS

No se puede actualizar la imagen porque el sistema está creando una instantánea para el teléfono en la nube "%s". Inténtelo de nuevo más tarde.

GuestOperateDesktopFail

No se pudo apagar ni reiniciar el teléfono en la nube.

GuestOperateDesktopTimeout

La operación de apagado o reinicio que ejecutó en el teléfono en la nube falló porque se agotó el tiempo de respuesta.

GuestRebootOperateFail

No se pudo reiniciar el teléfono en la nube.

GuestRebootOperateTimeout

La operación de reinicio que ejecutó en el teléfono en la nube falló porque se agotó el tiempo de respuesta.

GuestStopOperateFail

No se pudo apagar el teléfono en la nube.

GuestStopOperateTimeout

La operación de apagado que ejecutó en el teléfono en la nube falló porque se agotó el tiempo de respuesta.

InvalidDirectoryType

Ya no se admite el inicio de sesión de usuarios RAM. Comuníquese con su administrador de TI.

InvalidEmailVerifyCode

El código de verificación por correo electrónico es incorrecto. Introdúzcalo de nuevo.

InvalidMfaDeviceStatus

El dispositivo virtual de autenticación multifactor no es válido. Use el dispositivo asociado a su cuenta.

InvalidPassword

El nombre de usuario o la contraseña son incorrectos.

LoginError.MissingConcatForVerify

No puede completar la verificación de identidad porque esta cuenta la activó un administrador. Comuníquese con su administrador de TI.

LoginForbidden

No se pudo iniciar sesión. La autenticación de dispositivos de confianza está habilitada para la red de oficina o la organización. Solicite al administrador que deshabilite esta autenticación o que agregue manualmente el terminal actual como dispositivo de confianza.

LoginForbidden.LockedByAdmin

La cuenta de conveniencia está bloqueada. Solicite a su administrador de TI que la desbloquee manualmente.

LoginForbiddenByDevice

No se pudo iniciar sesión. El administrador especificó que solo ciertos usuarios pueden iniciar sesión en este terminal, y su cuenta no tiene autorización.

LoginForbiddenByUntrustedDevice

No se pudo iniciar sesión. El administrador habilitó "Block Logons of Untrusted Terminals". Es necesario que agregue este terminal como dispositivo de confianza o que deshabilite dicha función.

LoginForbiddenByUser

No se pudo iniciar sesión. El administrador habilitó restricciones de terminal para el inicio de sesión de usuarios. Inicie sesión desde un terminal autorizado.

MfaClientNotSupport

La versión del cliente es demasiado antigua y no es compatible con este método de autenticación multifactor. Actualice el cliente.

MfaNotAllowed

A su cuenta le falta la información obligatoria para este método de autenticación multifactor. Solicite a su administrador de TI que la agregue.

MfaTypeNotAllowed

Su administrador de TI no habilitó este método de autenticación multifactor.

MfaUserGoingToBeLocked

El código de verificación es incorrecto. Si introduce un código incorrecto 10 veces consecutivas, su cuenta se bloqueará durante 20 minutos.

MfaUserNotExist

Esta cuenta se eliminó. Comuníquese con su administrador de TI para obtener más detalles.

MfaVerifyCodeDiscarded

El código de verificación no es válido. Solicite uno nuevo.

PhoneIsNotRegistered

El número de celular es incorrecto o el administrador no lo asoció con la cuenta.

SessionForceQuit

Se cerró su sesión automáticamente. Esto puede deberse a que cerró sesión desde otro terminal o a que la cantidad de terminales con sesión iniciada superó el límite establecido por su administrador de TI.

StartApplicationGuestTimeout

La aplicación no se inició debido a una conexión de red inestable. Inténtelo de nuevo.

StartDesktopFail

No se pudo iniciar el teléfono en la nube.

ThrottlingSendEmailVerifyCodeLimit

Solo puede solicitar un código de verificación una vez por minuto.

UnavailableDesktop.2907

La conexión con el teléfono en la nube falló porque el servicio de protocolo aún se está iniciando. Intente conectarse de nuevo más tarde o reinicie el teléfono en la nube. Si el problema persiste, comuníquese con su administrador de TI.

Preguntas frecuentes

Deshabilitar DesktopAssistant

Para deshabilitar DesktopAssistant, inicialice uiConfig cuando llame a createSession.

uiConfig: {
  toolbar: {
    visible: false,
  },
},

Enviar comandos ADB mediante el canal ASP

Inicialice lyncChannelConfig cuando llame a createSession.

lyncChannelConfig: [
  {
    lyncChannelName: "lync_adb_shell",
  },
],

Para enviar un comando, llame a session.sendLyncMessage. Por ejemplo:

session.sendLyncMessage(
    "lync_adb_shell",
    JSON. stringify({
        id: crypto. randomUUID(), 
        cmd: 'input keyevent KEYCODE_VOLUME_UP',
    })
);

Para recibir el resultado del comando, agregue un listener llamando a session.addLyncListener. Por ejemplo:

session.addLyncListener('lync_adb_shell', 'onReceivedLyncData', data => console.log('data from lync_adb_shell', data));

A continuación se muestran algunos comandos comunes:

Función

Comando

Tecla de retroceso

input keyevent KEYCODE_BACK

Tecla de inicio

input keyevent KEYCODE_HOME

Tecla de cambio de aplicación

input keyevent KEYCODE_APP_SWITCH

Silenciar

input keyevent 164

Subir volumen

input keyevent KEYCODE_VOLUME_UP

Bajar volumen

input keyevent KEYCODE_VOLUME_DOWN

Ocultar barra de navegación

setprop persist.wy.hasnavibar false; killall com.android.systemui

Mostrar barra de navegación

setprop persist.wy.hasnavibar true; killall com.android.systemui

Captura de pantalla

screencap -p /sdcard/Download/abc.png

Uso de la cámara

  • Si usa la demostración para conectarse a un teléfono en la nube, tenga en cuenta que los navegadores controlan los permisos de la cámara. Para que funcione correctamente, la URL de la demostración debe comenzar con https.

  • Si desea usar únicamente la cámara frontal o trasera del cliente, aplique la siguiente configuración.

// Front camera
session.setLocalConfig('setCameraType', 1);
// Rear camera
session.setLocalConfig('setCameraType', 2);

Uso del portapapeles

  • Si el portapapeles no funciona:

    • Compruebe si los permisos del portapapeles están habilitados en su navegador.

    • En la consola de Cloud Phone, revise la política de la instancia para asegurarse de que la transferencia bidireccional del portapapeles esté habilitada.