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
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:
-
Compruebe si Node.js está instalado:
nodeSi aparece el mensaje
Welcome to Node.js, significa que Node.js ya está instalado.Si no ve este mensaje, instale Node.js.
-
Vaya al directorio raíz del proyecto de Vue:
NotaReemplace
<ProjectRootPath>con la ruta al directorio raíz del proyecto de Vue.cd <ProjectRootPath> -
Instale las dependencias:
npm i -
Inicie el proyecto:
npm run devSi la operación se completa correctamente, se devuelve una URL accesible.
-
-
Para iniciar WuyingWebDemo.html:
-
Vaya al directorio donde se encuentra el archivo HTML:
NotaReemplace
<HTMLPath>con la ruta al directorio del archivo HTML.cd <HTMLPath> -
Inicie el servidor HTTP:
python3 -m http.server En su navegador, abra
http://localhost:8000/WuyingWebDemo.html.
-
1.2 Flujo de integración
1.3 Mejores prácticas
Consulte Best practices for quick integration of cloud phones. La siguiente figura muestra la arquitectura de integración.
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.
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 |
|
sessionParams |
SessionParam |
Sí |
Los parámetros para crear una sesión. Consulte 4.1 SessionParam. |
Parámetros de sessionParams
-
userInfo:
sessionId: elSessionIdque devuelve la operaciónGetLoginTokenoGetStsToken.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.
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
openTypeen 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 |
setInputEnabled(param: boolean) enableInput(param: boolean) | Habilita o deshabilita la entrada de datos.
|
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: |
dataChannel | Un canal de datos personalizado para enviar y recibir información entre el cliente y la nube. |
lyncChannel | Un canal para que el cliente envíe comandos ADB. |
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: |
|
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: |
|
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: |
|
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 |
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 |
|
appId |
string |
Sí |
El identificador persistente de la instancia de la aplicación ( |
|
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: |
|
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 |
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 ( |
|
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: |
|
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: |
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 |
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 |
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.