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
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
Descomprima el SDK y cópielo en su proyecto.
-
Vincule la biblioteca del SDK.
Vaya a Target --> Build Phases --> Link Binary With Libraries --> + --> Add Other --> Add Files y seleccione el framework obligatorio.
-
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
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.
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.
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 |
|
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 |
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 - (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 |
@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 |
- (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 |
DataChannel | Canal de datos personalizado para la comunicación entre el cliente y el sistema invitado. Para ver un ejemplo, consulte |
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.
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 respuestaacksi 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 |
|
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 ( | 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 |