Todos los productos
Search
Centro de documentos

Cloud Phone:SDK de iOS

Última actualización: Oct 15, 2026

Integre el SDK de iOS para Cloud Phone en su aplicación para transmitir e interactuar con instancias de teléfonos en la nube.

1. Inicio rápido

1.1 Obtener el SDK y la 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.

Requisitos de integración

Versión mínima de iOS compatible: 10.0.

Debido a la disponibilidad de las API de iOS, las funciones de mouse y teclado periféricos requieren iOS 13.4 o posterior.

Integración del SDK

  1. Descomprima el SDK y cópielo en su proyecto.

  2. Vincule la biblioteca del SDK.

    Vaya a Target --> Build Phases --> Link Binary With Libraries --> + --> Add Other --> Add Files y seleccione el framework obligatorio.

  3. Establezca la opción de inserción.

    Vaya a Target --> General --> Frameworks, Libraries, and Embedded Content, busque ASPEngineSDK.framework y seleccione Embed Without Signing.

Permisos del SDK

Agregue al archivo Info.plist de su proyecto los permisos que ASPEngineSDK requiere.

1. Permiso de micrófono

Privacy - Microphone Usage Description

2. Permiso de cámara

Privacy - Camera Usage Description

Firma del SDK

El SDK es una biblioteca dinámica. Debe firmarlo para depurar en un dispositivo físico o para enviarlo al App Store.

  • Obtener un identificador de firma

Para encontrar su identificador de firma, ejecute:

security find-identity -v -p codesigning

Si no cuenta con un certificado local, inicie sesión en su cuenta de Apple Developer y descargue el perfil de aprovisionamiento. Haga clic derecho en el archivo descargado, elija Get Info y busque el campo SHA-1 del certificado de destino. Este valor es el identificador de firma.

  • Signing & Capabilities

En el target de su proyecto, configure correctamente el certificado en la pestaña Signing & Capabilities.

  • Agregue un script de shell para la firma. Este script es obligatorio para dispositivos físicos, pero no para simuladores.

Vaya a Target --> Build Phases --> + --> New Run Script Phase y pegue el contenido del script de shell. Consulte el ejemplo de script de shell de firma a continuación.

Nota: Esta fase Run Script debe colocarse después de la fase Embed Frameworks.

  • Ejemplo de script de shell de firma

set -e
SHELL_PATH="${PROJECT_DIR}/ASPDemo/Lib/ASPEngineSDK/ASPEngineSDK.framework/link_and_sign.sh"
KEY_ID="Your certificate's signing ID"
echo "===> Signing using $KEY_ID"
/bin/bash -c "${SHELL_PATH}"\ "${TARGET_BUILD_DIR}"\ "${FRAMEWORKS_FOLDER_PATH}"\ "${KEY_ID}"

Configuración del proyecto

Deshabilite Bitcode.

Vaya a Target --> Build Settings --> Build Options --> Enable Bitcode y establezca la opción en No.

1.2 Flujo de trabajo de integración

image

1.3 Mejores prácticas

Consulte Best practices for quick integration with cloud phones. A continuación se muestra un diagrama que describe la arquitectura de integración.

image

Varios métodos de inicio de sesión proporcionan el ticket de conexión que el SDK requiere. El siguiente diagrama ilustra estos flujos de trabajo.

image

Para ver ejemplos de código, consulte el código de muestra de la API de ciclo de vida.

2. API de ciclo de vida

2.1 Inicializar la instancia

+ (instancetype)buildStreamView;

2.2 Establecer la conexión

- (void)startWithTicket:(ASPConnTicket*) ticketParam;

Parámetros de ASPConnTicket:

Parámetro

Descripción

connTicket

Ticket de conexión para la autenticación.

caFilePath

Ruta absoluta al archivo CA para el cifrado TLS.

desktopId

Identificador de la instancia de la aplicación, como ai-0cc7s3n1iagyq****. Obtenga este identificador mediante la llamada a la API Query Instance Details.

useVpc

Indica si se establece la conexión a través de una VPC.

enableTls

Habilita la transmisión cifrada. Valor recomendado: YES.

enableStatistics

Habilita el seguimiento. Valor recomendado: YES.

preferRtcTransport

Habilita el canal RTC. Valor recomendado: YES.

2.3 Desconectar

- (int)stop;

2.4 Pausar

Pausa la transmisión desde el servidor y el renderizado en el cliente.

- (void)pause;

2.5 Reanudar

Reanuda la transmisión desde el servidor y el renderizado en el cliente.

- (void)resume;

2.6 Liberar la instancia

- (void)dispose;

2.7 Callbacks

// Callbacks for the Elastic Cloud Phone connection.
@property (nonatomic, weak) id<ASPEngineDelegate> engineDelegate;
// Callback for resolution changes.
@property (nonatomic, weak) id<ASPEngineResolutionUpdateDelegate> resolutionUpdateDelegate;
// Callbacks for the mouse cursor.
@property (nonatomic, weak) id<ASPEngineCursorDelegate> cursorDelegate;
// Callback for orientation changes of the Elastic Cloud Phone.
@property (nonatomic, weak) id<ASPEngineOrientationUpdateDelegate> orientationUpdateDelegate;
// Callbacks for tracking.
@property (nonatomic, weak) id<ASPEngineStatisticsDelegate> statisticsDelegate;
// Callbacks for the Input Method Editor (IME). Not supported by Elastic Cloud Phone.
@property (nonatomic, weak) id<ASPEngineIMEDelegate> imeDelegate;
// Callbacks for logs. We recommend using a singleton for the delegate.
+ (void)setASPEngineLogDelegate:(id<ASPEngineLogDelegate>)delegate;
+ (void)unsetASPEngineLogDelegate;

ASPEngineDelegate: callbacks para las conexiones de Elastic Cloud Phone

API

Descripción

onConnectionSuccess:(int)connectId

Se invoca cuando se establece la conexión con el ECP. Devuelve el identificador de la conexión.

onConnectionFailureWithErrCode:(int)errCode errMsg:(NSString*)errMsg

Se invoca cuando falla la conexión con el ECP. Devuelve un código de error y un mensaje de error.

onEngineErrorWithErrCode:(int)errCode errMsg:(NSString*)errMsg

Se invoca cuando ocurre un error interno del SDK. Devuelve un código de error y un mensaje de error.

onDisconnected:(int)reason

Se invoca cuando se interrumpe la conexión con el ECP. Devuelve el código del motivo de desconexión.

onFirstFrameRendered:(long)timeCostMS

Se invoca cuando se renderiza el primer fotograma del ECP. Devuelve el tiempo transcurrido en milisegundos.

onReconnect:(int)errorCode

Se invoca cuando el SDK intenta reconectarse. Devuelve el código de error que activó la reconexión.

onPolicyUpdate:(NSString *)policy

Se invoca cuando se actualiza la política del ECP. Devuelve la configuración de la política.

onUpdateNetworkQos:(AspNetworkQoS)qos

Informa el estado de calidad de servicio (QoS) de la red.

onSessionSuccess

Se invoca cuando se crea la sesión del ECP.

ASPEngineResolutionUpdateDelegate: callbacks para cambios de resolución

API

Descripción

onResolutionUpdateWithOldWidth:(int)oldWidth oldHeight:(int)oldHeight width:(int)width height:(int)height

Se invoca cuando cambia la resolución. Devuelve la resolución anterior y la nueva.

onMonitorsDpiConfig:(int)dpi maxSupportDpi:(int)maxSupportDpi

Proporciona la configuración de PPP y el máximo de PPP compatible. Elastic Cloud Phone no admite esta función.

ASPEngineCursorDelegate: callbacks para el cursor del mouse

API

Descripción

onCursorBitmapUpdateWithHotX:(int)hotX hotY:(int)hotY

width:(int)width height:(int)height rgba:(char*)rgba

Se invoca cuando se actualiza el mapa de bits del cursor. Proporciona las coordenadas del punto activo, las dimensiones y los datos RGBA del cursor.

onCursorReset

Se invoca cuando se restablece el cursor del mouse.

onCursorHide

Se invoca cuando se oculta el cursor del mouse.

onCursorMoveWithX:(int)x y:(int)y

Se invoca cuando el cursor del mouse se mueve. Proporciona las nuevas coordenadas.

ASPEngineStatisticsDelegate: callbacks para el seguimiento

API

Descripción

onStatisticsInfoUpdate:(ASPStatisticsInfo *)info

Informa las estadísticas de rendimiento del ECP en un objeto ASPStatisticsInfo.

ASPEngineLogDelegate: callbacks para los registros. Se recomienda usar un singleton para este delegado.

API

Descripción

onLogMessage:(NSString*)msg

tag:(NSString*)tag

level:(AspLogLevel)level

Se invoca por cada mensaje de registro del SDK. Proporciona el mensaje, la etiqueta y el nivel de cada entrada.

3. API de servicio

API

Descripción

- (BOOL)enableStatistics:(BOOL) enabled enableGuestInfo:(BOOL)enableGuestInfo

Habilita o deshabilita las estadísticas y la recopilación del uso de CPU del sistema invitado.

- (BOOL)enableMouseMode:(BOOL)enabled

Habilita o deshabilita el modo de mouse.

@property (nonatomic, assign) BOOL enableDump;

Habilita o deshabilita el volcado de datos. Esta función afecta el rendimiento y está diseñada solo para desarrollo y depuración. No la use en producción.

- (BOOL)sendKeyboardEvent: (ASPKeyEvent) event;

Envía un evento de teclado.

// The leftButton parameter specifies whether to simulate a left or right button click. The click position is (0, 0).

- (BOOL)simulateMouseClick:(BOOL)leftButton;

- (BOOL)simulateMouseClick:(BOOL)leftButton x:(float)x y:(float)y;

Simula un clic del mouse.

- (void)hideCursor;

- (void)showCursor;

Oculta o muestra el cursor.

- (void)setVideoProfileWithWidth:(int)width height:(int)height fps:(int)fps;

Establece la resolución. Actualmente, el parámetro fps no es compatible.

@property (nonatomic, assign) BOOL mute;

Silencia o reactiva el audio.

@property (nonatomic, assign) ASPScaleType scaleType;

Tipo de escala para la transmisión de video. Consulte la sección 5.1 ASPScaleType.

- (void)enableDesktopMode:(BOOL)enabled;

Habilita o deshabilita el modo de escritorio. Cuando está habilitado, los mensajes táctiles se convierten en eventos de mouse. Para teléfonos en la nube, el valor recomendado es NO.

- (void)enableDesktopGesture:(BOOL)enabled;

Habilita o deshabilita los gestos de zoom y desplazamiento en el cliente. Para teléfonos en la nube, el valor recomendado es NO.

@property (nonatomic, assign) BOOL enableTouchFeel;

Habilita o deshabilita la retroalimentación háptica. El valor predeterminado es NO.

LyncChannel

Canal para enviar comandos ADB. Para ver un ejemplo, consulte DemoLyncChannel en la demostración.

DataChannel

Canal de datos personalizado para la comunicación entre el cliente y el sistema invitado. Para ver un ejemplo, consulte DemoEDSAgentChannel en la demostración.

Ejemplo de LyncChannel
// The default LyncChannel name is: static NSString *LYNC_CHANNEL_NAME = @"lync_adb_shell";
// Add the LyncChannel
self.lync = [[DemoLyncChannel alloc] initWithParameter:LYNC_CHANNEL_NAME];
[self.streamView addLyncChannel:self.lync];
// Remove the LyncChannel
[self.streamView removeLyncChannel:self.lync];
// LyncChannel implementation
@interface DemoLyncChannel : BaseLyncChannel
@property (nonatomic, strong) NSString *lslaID;

@end
@implementation DemoLyncChannel

- (void)onConnectStateChanged:(BOOL)connected {
    NSLog(@"[DemoLyncChannel] onConnectStateChanged %d", connected);
    if (connected) {
        // Test sending a command
        self.lslaID = [DemoToolBox getID];
        NSString *cmdData = [DemoToolBox getJsonDataWithId:self.lslaID cmd:@"ls -la"];
        NSLog(@"[DemoLyncChannel] cmdData : %@", cmdData);
        LyncErrorCode code = [self sendString:cmdData];
        NSLog(@"[DemoLyncChannel] cmdData code: %ld", code);
    }
}
- (void)onReceiveStringData:(NSString * _Nonnull)buf {
    NSLog(@"[DemoLyncChannel] onReceiveStringData %@", buf);
    NSDictionary *dic = [DemoToolBox convertStringToJSON:buf];
    NSString *ID = [dic objectForKey:@"id"];
    if (ID != NULL && ID.length && [self.lslaID isEqualToString:ID]) {
        NSLog(@"[DemoLyncChannel] onReceiveStringData: Received result for 'ls -la'.");
    }
}
- (void)onReceiveRawData:(NSData * _Nonnull)buf {
    NSString *string = [[NSString alloc] initWithData:buf encoding:NSUTF8StringEncoding];
    NSLog(@"[DemoLyncChannel] onReceiveRawData %@", string);
}
@end
Ejemplo de DataChannel
// The default DataChannel name is: static NSString *DATA_CHANNEL_NAME = @"wy_vdagent_default_dc";
// Add the DataChannel
self.esdAgent = [[DemoEDSAgentChannel alloc] initWithParameter:DATA_CHANNEL_NAME];
[self.streamView addDataChannel:self.esdAgent];
// Remove the DataChannel
[self.streamView removeDataChannel:self.esdAgent];
// DataChannel implementation
@interface DemoEDSAgentChannel : BaseEDSAgentChannel
@end
@implementation DemoEDSAgentChannel

- (void)onConnectStateChanged:(ASPDCConnectState)state {
    NSLog(@"[DemoEDSAgentChannel] onConnectStateChanged %ld", state);
    if (state == OPEN) {
        // to send data
    }
}
- (void)onReceiveData:(NSData * _Nonnull)buf {
    NSString *string = [[NSString alloc] initWithData:buf encoding:NSUTF8StringEncoding];
    NSLog(@"[DemoEDSAgentChannel] onReceiveData %@", string);
}
@end

El canal de mensajes utiliza el DataChannel denominado wy_vdagent_default_dc.

El tamaño del mensaje tiene un límite de 500 KB.

El formato básico del mensaje es el siguiente:

DataChannel: mensajes del cliente al sistema invitado

Acción: insertcontact, insertsms o sendcontactvcf

  • insertcontact: inserta un contacto.

El parámetro obligatorio name especifica el nombre del contacto.

El parámetro obligatorio phonenumber especifica el número de teléfono.

  • insertsms: inserta un SMS.

El parámetro obligatorio phonenumber especifica el número de teléfono.

El parámetro obligatorio textbody especifica el contenido del SMS.

El parámetro opcional canInsertdb indica si se inserta el mensaje en la base de datos de SMS del teléfono en la nube. El valor predeterminado es 0 (no insertar); establézcalo en 1 para insertarlo.

Ejemplo: let jsonarray = [{'action': 'insertcontact','importdata':[{ 'name': '**', 'phonenumber': '**' }, { 'name': '**', 'phonenumber': '**' }]},{'action': 'insertsms','importdata':[{'phonenumber':'**','textbody':'**,"canInsertdb":0/1}]}]

  • sendcontactvcf: inserta contactos desde un archivo vcf.

El parámetro obligatorio data contiene el flujo de datos del archivo vcf. Los archivos grandes deben dividirse en fragmentos, con un tamaño máximo de 1 MB por fragmento.

El parámetro obligatorio allsize representa el tamaño total de los datos vcf.

Nota

El parámetro timestamp es obligatorio. Use la misma marca de tiempo en todos los fragmentos de un mismo archivo vcf para garantizar que se vuelvan a ensamblar correctamente.

Ejemplo: {'action': 'sendcontactvcf', 'importdata': {'data': '', 'allsize': total_file_size, 'timestamp': current_timestamp}}.

public void processByteArrayInChunks(byte[] data) {
    int chunkSize = 512 * 1024; // 512 KB
    int length = data.length;
    long timestamp = System.currentTimeMillis();
    for (int i = 0; i < length; i += chunkSize) {
        int end = Math.min(i + chunkSize, length);
        byte[] chunk = Arrays.copyOfRange(data, i, end);
        String str = new String(chunk, StandardCharsets.UTF_8);
        /**
          {'action': 'sendcontactvcf','importdata':{"data":str, "allsize":length, "timestamp":timestamp}}
        */
    }
}
String recvData = "";
int recvSize = 0;
long recvTimestamp = 0;
public void onMessageReceive(byte[] message) {
  String action = getAction(message);
  String data = getData(message);
  int length = data.length;
  int allSize = getAllSize(message);
  long timestamp = getTimestamp(message);
  if (timestamp != recvTimestamp) {
    clearRecv();
  }
  if (action.equals("sendcontactvcf")) {
    recvSize += length;
    recvData = recvData + data;
    if (recvSize >= allSize) {
      // Write recvData to a vcf file and insert contacts.
      insertContact(vcfFilePath);
      sendack();
      clearRecv();
    }
  }
}

public void clearRecv() {
  recvData = "";
  recvSize = 0;
  recvTimestamp = 0;
}

DataChannel: mensajes del sistema invitado al cliente

Acción: openeditsms, openphone o rotation

  • openeditsms: abre la página del editor de SMS.

El parámetro opcional importdata.phonenumber especifica el número de teléfono.

El parámetro opcional textbody especifica el contenido del SMS.

Ejemplo: {'action': 'openeditsms',importdata:{"phonenumber":"***", "textbody":"***"}}

  • openphone: abre la página del marcador telefónico.

El parámetro opcional importdata.phonenumber especifica el número al que se llamará. Si se proporciona, el marcador se abre con ese número; de lo contrario, se abre la página principal del marcador.

Ejemplo: {'action': 'openphone','importdata':{"phonenumber":"***"}} o {'action': 'openphone'}

Mensaje ACK de DataChannel

Acción: ack

  • ack: informa el estado de procesamiento de un mensaje recibido. Tanto el cliente como el sistema invitado pueden enviar una respuesta ack si la lógica de la aplicación lo requiere.

El parámetro obligatorio source corresponde a la acción del mensaje original.

El parámetro obligatorio code es el código de estado, con los siguientes valores válidos: 0 (desconocido), 1 (en ejecución), 2 (exitoso), 3 (fallido) y 4 (no compatible).

Ejemplo: {'action': 'ack','importdata':{"source":"***", "code": *,"id":*}}

4. Parámetros

4.1 ASPConnTicket

Parámetros de configuración para establecer una conexión.

Parámetro

Descripción

connTicket

Ticket de autenticación de la conexión.

caFilePath

La ruta absoluta al archivo CA, utilizada para el cifrado TLS.

desktopId

Identificador de la instancia de la aplicación, como ai-0cc7s3n1iagyq****. Obtenga este identificador mediante la llamada a la API Query Instance Details.

useVpc

Indica si se establece la conexión a través de una VPC.

enableTls

Habilita el cifrado TLS. Valor recomendado: YES.

enableStatistics

Habilita las estadísticas. Valor recomendado: YES.

preferRtcTransport

Habilita el canal RTC. Valor recomendado: YES.

4.2 ASPStatisticsInfo

Datos de rendimiento.

API

Tipo

Descripción

mReceiveFps

int

FPS recibidos

mRenderFps

int

FPS de renderizado

mDownstreamBandwithMBPerSecond

double

Ancho de banda descendente

mUpstreamBandwithMBPerSecond

double

Ancho de banda ascendente

mP2pFullLinkageLatencyMS

long

Latencia completa de extremo a extremo. Obsoleto.

mNetworkLatencyMS

long

RTT de red

mPingGatewayRtt

long

RTT de ping

mLostRate

double

Tasa de pérdida de paquetes

mServerRenderLatencyMS

long

Latencia de renderizado en el servidor

mServerEncoderLatencyMS

long

Latencia de codificación en el servidor

mServerTotalLatencyMS

long

Latencia total en el servidor

accumulateBandwidth

long

Ancho de banda total

mGuestCpuUsage

long

Uso de CPU del sistema invitado

mStreamType

String

Tipo de protocolo de transmisión

infoDic

NSDictionary

Mapa de datos de rendimiento.

5. Tipos de enumeración

5.1 ASPScaleType

Tipo de escalado de contenido para una imagen transmitida.

Parámetro

Descripción

ASPScaleTypeFill

Estira la imagen transmitida para llenar todo el StreamView. Esto puede causar distorsión si la relación de aspecto de la imagen difiere de la de la vista.

ASPScaleTypeFit

Escala la imagen transmitida para que encaje dentro del StreamView y conserva su relación de aspecto. Muestra la imagen completa sin distorsión, aunque puede dejar partes de la vista vacías.

Códigos de error

Código de error

Mensaje de error (%s representa un teléfono en la nube o una aplicación en la nube)

Módulo

Causa

Los códigos de error del 2 al 26 están relacionados principalmente con problemas de red.

2

Error al conectarse a %s.

ASP SDK

El valor MAGIC no es válido.

3

Error al conectarse a %s.

ASP SDK

Datos no válidos.

4

Las versiones del cliente y del servidor no coinciden.

ASP SDK

Incompatibilidad de versiones.

5

Se requiere una conexión TLS.

ASP SDK

El servidor exige una conexión TLS, pero el cliente no inició ninguna.

6

Conexión TLS inesperada.

ASP SDK

La conexión no requiere TLS, pero se utilizó este protocolo.

7

Permiso denegado para conectarse a %s.

ASP SDK

Permisos insuficientes.

8

ID de cliente no válido durante la migración.

ASP SDK

El ID de cliente no es válido durante la migración.

9

Error al conectarse a %s.

ASP SDK

El canal no existe.

20

Error al conectarse al servidor ASP.

ASP SDK

Error de conexión del canal.

21

Ocurrió un error de autenticación TLS.

ASP SDK

Error de autenticación TLS.

22

Error al conectarse a %s.

ASP SDK

Error en el enlace del canal.

23

Error al conectarse a %s.

ASP SDK

Error de autenticación de la conexión.

24

Error al conectarse a %s.

ASP SDK

Error de E/S en la conexión.

25

Error al conectarse a %s.

ASP SDK

La validación del ticket falló. Este error también ocurre cuando se reutiliza un ticket de una sesión finalizada.

26

El handshake de xquic falló.

ASP SDK

El handshake de xquic falló.

1206

El ticket ya está en uso.

ASP SDK

Un ticket se puede reutilizar, pero solo para una conexión a la vez. Este error ocurre si intenta establecer una conexión nueva mientras el teléfono en la nube ya está en uso.

1207

Ticket invalidado por el reinicio de la instancia.

ASP SDK

La instancia se reinició, lo que invalidó el ticket.

Códigos de error del SDK para el modo colaborativo

1000

El token está vacío.

ASP SDK

Estos errores ocurren únicamente en el modo colaborativo cuando falla la validación secundaria entre el cliente y el servidor.

1001

El usuario está vacío.

ASP SDK

1200

El token no es válido.

ASP SDK

1201

La VM no es válida.

ASP SDK

1202

Ocurrió un error interno del administrador.

ASP SDK

1203

El usuario no es válido.

ASP SDK

1204

El token caducó.

ASP SDK

1500

Ocurrió un error interno del servidor.

ASP SDK

1501

Ocurrió un error de red en el servidor.

ASP SDK

Interrupciones de conexión y otros errores

2000

Se perdió la conexión con el servidor porque se agotó el tiempo de espera al obtener datos de %s.

ASP SDK

Tiempo de espera agotado al obtener datos.

2001

%s se desconectó del servidor, posiblemente porque su proceso finalizó.

ASP SDK

Esto suele ocurrir cuando finaliza el proceso del lado del cliente. Por ejemplo, cuando el usuario cierra una aplicación Android al presionar el botón Inicio.

2002

Otro usuario se conectó a la %s actual desde una terminal distinta.

ASP SDK

Otro usuario tomó el control de la sesión en modo preventivo.

2003

%s se está apagando o reiniciando. Normalmente, esta acción la inicia un administrador.

ASP SDK

El teléfono en la nube se apagó o se reinició, generalmente por acción de un administrador.

2004

La conexión del usuario actual finalizó.

ASP SDK

El cliente inició la desconexión o el servidor activó una acción de expulsión o desconexión.

2005

Sesión desconectada: se alcanzó el límite de tiempo de uso.

ASP SDK

La sesión finalizó porque alcanzó el límite de duración de uso configurado por el administrador.

2006

El administrador revocó su permiso para usar este teléfono en la nube. Se cerrará su sesión y se desconectará.

ASP SDK

Un administrador revocó la autorización del usuario.

2010

Error al conectarse a %s.

ASP SDK

Error al conectarse a Vdagent.

2011

Ocurrió un error al pasar los parámetros de conexión.

ASP SDK

Se pasó un parámetro no válido al conectarse al servidor.

2027

Se cambió el modo de extracción de flujo.

ASP SDK

El modo de extracción de flujo cambió de preventivo a colaborativo, o de colaborativo a preventivo.

2100

Permiso de portapapeles denegado para copiar de %s al dispositivo local.

ASP SDK

La política deniega el acceso al portapapeles desde la instancia remota hacia el cliente local.

2101

Permiso de portapapeles denegado para copiar del dispositivo local a %s.

ASP SDK

La política deniega el acceso al portapapeles desde el cliente local hacia la instancia remota.

2200

%s está intentando reconectarse...

ASP SDK

La conexión se perdió debido a un problema de red y ASP SDK está intentando reconectarse.

2201

Su dispositivo presentó una anomalía de red, lo que provocó la desconexión de %s.

ASP SDK

La conexión se perdió por un problema de red. ASP SDK no admite la reconexión debido a restricciones de imagen; la aplicación debe iniciarla.

2202

Se agotó el tiempo de espera para reconectarse a %s.

ASP SDK

Se agotó el tiempo de espera del intento de reconexión de ASP SDK.

2210

La conexión se perdió mientras el dispositivo cliente estaba en suspensión.

ASP SDK

La red local se desconectó mientras el dispositivo cliente estaba en suspensión, lo que provocó la pérdida de conexión con el teléfono en la nube.

2212

La conexión se perdió debido a una anomalía en la red local.

ASP SDK

Se detectó una anomalía en la red local que provocó la desconexión del teléfono en la nube.

2220

La conexión se perdió debido a una anomalía en la red local.

ASP SDK

Se detectó una anomalía en la red local que provocó la desconexión del teléfono en la nube.

2240

La reconexión falló porque el token del ticket no es válido.

ASP SDK

2300

La conexión falló debido a un parámetro no válido proveniente de la aplicación.

app-side

2501

El cliente no pudo conectarse al stream gateway. La red es inaccesible.

stream gateway

2502

El cliente no pudo conectarse al stream gateway. La conexión TCP a la dirección IP del stream gateway agotó el tiempo de espera después de tres intentos (15 segundos en total).

stream gateway

2503

El cliente no pudo conectarse al stream gateway debido a un error de red desconocido.

stream gateway

2504

El cliente no pudo conectarse al stream gateway. El software canceló la conexión.

stream gateway

2505

El cliente no pudo conectarse al stream gateway. La conexión fue rechazada.

stream gateway

2506

El ticket no es válido. El gateway no pudo analizar sintácticamente el token.

stream gateway

2507

El ticket no es válido porque caducó.

stream gateway

2508

El ticket no es válido debido a una discrepancia de UUID.

stream gateway

2509

El stream gateway no pudo sondear el servidor ASP.

stream gateway

2510

Se rechazó el sondeo al servidor. Solución: asegúrese de que el servidor esté escuchando en el puerto 5912.

stream gateway

2511

El sondeo al servidor falló debido a un error distinto de un tiempo de espera agotado o un rechazo.

stream gateway

2512

La validación del token del stream gateway falló.

El ID de VPC del token de administración no coincide con el ID de VPC del stream gateway.

stream gateway

2513

La conexión TCP se restableció durante el handshake "SayHello" entre el cliente y el stream gateway.

stream gateway

2520

La conexión del cliente falló; un diagnóstico automático indica una anomalía de red.

ASP SDK

2521

El cliente se desconectó tras tres intentos de reconexión con errores durante la fase de handshake TLS con el stream gateway.

ASP SDK

2522

Ocurrió un error de conexión en un entorno VPN.

ASP SDK

2523

El cliente intenta conectarse mediante el conjunto de protocolos GM/T. Compruebe la configuración del servidor o seleccione un método de conexión compatible.

ASP SDK

2701

Ocurrió un problema de red del lado del cliente.

ASP SDK

2702

Se agotó el tiempo de espera del handshake SSL entre el cliente y el stream gateway.

ASP SDK

2703

Se agotó el tiempo de espera del handshake "SayHello" entre el cliente y el stream gateway.

ASP SDK

2704

Se agotó el tiempo de espera de la respuesta del servidor ASP a la solicitud de establecimiento de conexión.

Posibles causas: el servidor ASP no responde, anomalía de red, instancia congelada o uso elevado de memoria o CPU.

ASP SDK

2705

El cliente ASP agotó el tiempo de espera mientras esperaba el primer fotograma.

Posibles causas: el servidor ASP no responde, no se generan fotogramas por un problema con la captura de pantalla o el controlador de GPU, anomalía de red o uso elevado de memoria o CPU.

ASP SDK

2706

Un uso elevado de CPU o memoria local en el cliente puede provocar errores de conexión.

ASP SDK

2707

El servidor ASP agotó el tiempo de espera al recuperar el primer fotograma de captura de pantalla del sistema operativo invitado.

ASP SDK

2708

La conexión falló porque un hilo del SDK se bloqueó.

ASP SDK

Errores de lógica del lado del cliente

5100

Se agotó el tiempo de espera de la conexión de %s al servidor ASP.

app-side

El lado del cliente no recibió un evento "connected" dentro del periodo de tiempo especificado.

5102

Se agotó el tiempo de espera al obtener datos de %s.

app-side

El lado del cliente recibió un evento "connected", pero no recibió un evento "display" dentro del periodo de tiempo especificado.

5004

Parámetros de inicio no válidos.

app-side

Se pasaron parámetros de inicio no válidos al lado del cliente. Esto suele ocurrir durante el desarrollo.

5200

Se agotó el tiempo de espera de la reconexión del cliente.

app-side

Preguntas frecuentes

Reiniciar Elastic Cloud Phone

Para reiniciar una instancia, llame a la API Restart Instance. Esta acción desconecta el ECP del cliente. Una vez que la instancia se reinicie, vuelva a conectarse a ella.

Comandos comunes de ADB

Función

Comando

Botón Atrás

input keyevent KEYCODE_BACK

Botón Inicio

input keyevent KEYCODE_HOME

Botón Cambiar 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