Todos los productos
Search
Centro de documentos

Cloud Phone:SDK de Android

Última actualización: Oct 16, 2026

El SDK de Alibaba Cloud Workspace para Android proporciona una interfaz abierta para conectarse a computadoras en la nube, aplicaciones en la nube y teléfonos en la nube. Al integrar el SDK, puede personalizar y construir rápidamente un cliente de Android adaptado a las necesidades de su negocio.

1. Inicio rápido

1.1 Obtener el SDK y la demostración

Nota

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

Estos documentos, SDK y clientes son únicamente para uso interno. No los distribuya a terceros sin autorización de Alibaba Cloud.

Requisitos del entorno

Versión mínima de Android compatible: 5.1

Integración del paquete AAR

  • Copie los archivos aspengine-third-release.aar, aspengine-player-release.aar y wytrace-release.aar al directorio app/libs.

  • Agregue a continuación las dependencias al archivo build.gradle del módulo de su aplicación:

dependencies {
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    // The INI configuration parsing library required by aspengine-sdk.
    implementation 'org.ini4j:ini4j:0.5.4'
    // The libraries required by wytrace.
    implementation 'com.squareup.okhttp3:okhttp:5.0.0-alpha.8'
    implementation 'com.google.code.gson:gson:2.10.1'
    implementation 'io.github.aliyun-sls:aliyun-log-android-sdk:2.7.0@aar'
}
  • Declare los permisos obligatorios en su archivo AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.VIBRATE"/>
  • Configure las reglas de conservación de ProGuard:

-keep class com.aliyun.wuying.aspsdk.** { *; }
-dontwarn com.aliyun.wuying.aspsdk.**

1.2 Proceso de integración

image

1.3 Mejores prácticas

Consulte Best practices for integrating Cloud Phone.

image

Existen varios métodos de inicio de sesión disponibles para obtener el ticket de conexión durante la integración del SDK.

image

Para ver ejemplos de código, consulte el código de muestra de las interfaces del ciclo de vida.

2. Interfaces del ciclo de vida

2.1 Inicializar una instancia de StreamView

@Override
protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   requestWindowFeature(Window.FEATURE_NO_TITLE);
   getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN);
   setContentView(R.layout.activity_stream_view_demo);
   mStreamView = findViewById(R.id.stream_view);
   mStreamView.enableDesktopMode(false);
   mStreamView.scaleStreamVideo(pref.getBoolean("fit_video_content", true) ?
   mStreamView.ScaleType.FIT_STREAM_CONTENT : StreamView.ScaleType.FILL_STREAM_VIEW);
   mStreamView.getASPEngineDelegate().setAlignStreamResolutionWithSurfaceSize(false);
}
<?xml version="1.0" encoding="utf-8"?>
<android.widget.RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".StreamViewDemoActivity">

    <com.aliyun.wuying.aspsdk.aspengine.ui.StreamView
        android:id="@+id/stream_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:focusableInTouchMode="true"
        android:focusable="true"
        android:focusedByDefault="true" />

</android.widget.RelativeLayout>

2.2 Establecer una conexión

Para obtener información sobre los valores de mConfigs, consulte la Sección 4.1.

mStreamView.start(mConfigs);

2.3 Cerrar la conexión

mStreamView.stop();

2.4 Destruir una instancia de StreamView

mStreamView.dispose();
mStreamView = null;

2.5 Modo multi-StreamView

Este modo le permite cambiar sin interrupciones una sola transmisión entre varias instancias de View. Para implementar este modo, siga estos pasos:

  1. Defina e inicialice las instancias de StreamView como se describe en la Sección 2.1.

  2. Utilice IAspEngine para establecer una conexión. Los parámetros deben coincidir con la definición de Config de la Sección 4.1.

    IASPEngine engine = mBuilder.enableRTC(true).build(context);
    // Enable data statistics.
    engine.enableStatistics(true, true);
    ConnectionConfig cc = new ConnectionConfig();
    cc.id = CONFIG_DESKTOP_ID;
    cc.connectionTicket = CONFIG_CONNECTION_TICKET;
    cc.useVPC = CONFIG_USE_VPC;
    cc.type = OS_TYPE;
    cc.user = CONFIG_USER;
    cc.uuid = CONFIG_UUID;
    
    engine.start(cc);
  3. Vincule IAspEngine a un StreamView. Esta llamada renderiza la transmisión en la View especificada.

    mStreamView.bindASPEngine(engine);
  4. Reanude la renderización en un StreamView. Esta llamada indica a la View que reanude la renderización de la transmisión.

    mStreamView.resumeASPEngine();

Para más detalles, consulte la implementación en la aplicación de demostración.

2.6 Devoluciones de llamada

Proxy de devolución de llamada de conexión: IASPEngineListener

Descripción de la interfaz:

API

Descripción

onConnectionSuccess(int connectionId)

Se activa cuando se establece correctamente una conexión con el teléfono en la nube. Devuelve el identificador de la conexión.

onConnectionFailure(int errorCode, String errorMsg)

Se activa si falla la conexión con el teléfono en la nube. Devuelve el código y el mensaje de error.

onEngineError(int errorCode, String errorMsg)

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

onDisconnected(int reason)

Se activa cuando se interrumpe la conexión. Devuelve el código entero del motivo de desconexión.

onReconnect(int errorCode)

Se activa cuando el SDK intenta reconectarse tras una desconexión. Devuelve el código de error que desencadenó la reconexión.

onFirstFrameRendered(long timeCostMS)

Se activa cuando se renderiza el primer fotograma de video. Devuelve el tiempo transcurrido desde el inicio de la conexión hasta el primer fotograma, en milisegundos.

onPolicyUpdate(String policy)

Se activa cuando se recibe una actualización de directiva desde el teléfono en la nube. Devuelve la configuración de la directiva como una cadena de texto.

onSessionSuccess()

Se activa cuando la sesión de streaming se establece correctamente.

Proxy de devolución de llamada de datos de rendimiento: IStatisticsListener

Descripción de la interfaz:

API

Descripción

onStatisticsInfoUpdate(StatisticsInfo statisticsInfo)

Se activa periódicamente para proporcionar datos de rendimiento. Devuelve un objeto StatisticsInfo que contiene las métricas más recientes.

Proxy de devolución de llamada para solicitud de permisos del sistema: IRequestSystemPermissionListener

Descripción de la interfaz:

API

Descripción

bool OnRequestSystemPermission(SystemPermission permission)

Se activa cuando el SDK necesita solicitar un permiso del sistema. El parámetro permission indica el tipo de permiso obligatorio.

Código de ejemplo para registrar y anular el registro de devoluciones de llamada:

// Listen for connection callbacks.
mStreamView.getASPEngineDelegate().registerASPEngineListener(IASPEngineListener listener);
mStreamView.getASPEngineDelegate().unregisterASPEngineListener(IASPEngineListener listener);
// Listen for performance data callbacks.
mStreamView.getASPEngineDelegate().registerStatisticsListener(IStatisticsListener listener);
mStreamView.getASPEngineDelegate().unregisterStatisticsListener(IStatisticsListener listener);
// Listen for system permission requests.
mStreamView.registerSystemPermissionListener(IRequestSystemPermissionListener listener);
mStreamView.unregisterSystemPermissionListener(IRequestSystemPermissionListener listener);

3. API del servicio

API

Descripción

enableVDAgentCheck(boolean enabled)

Especifica si se debe aplicar una comprobación de disponibilidad de VDAgent al establecer una conexión. Esta comprobación está habilitada de forma predeterminada.

Si se establece en true y VDAgent no está disponible durante el establecimiento de la conexión, se reporta un error y se finaliza la conexión actual.

No se recomienda establecer este parámetro en false, excepto para fines de depuración interna.

enableRTC(boolean enabled)

Especifica si se utiliza RTC para transmitir los datos de streaming. RTC se usa de forma predeterminada.

enableDesktopMode(boolean enabled)

Habilita o deshabilita el modo escritorio. Cuando está habilitado, toda la entrada táctil se convierte en eventos de ratón y se envía al servidor. Para teléfonos en la nube, se recomienda establecerlo en false.

scaleStreamVideo(ScaleType scaleType)

Especifica el comportamiento de escalado para la transmisión de video. Para conocer los valores válidos de ScaleType, consulte el tipo de enumeración 5.1 ScaleType.

setVideoProfile(int width, int height, int fps, IRemoteResult result)

Establece la resolución de la transmisión de video. Actualmente, el parámetro fps (tasa de fotogramas) no es compatible.

boolean sendKeyEvent(KeyEvent event)

y

sendKeyboardEvent(KeyEvent event, IRemoteResult result)

Envía eventos de teclado a la sesión remota.

boolean simulateMouseClick(boolean leftButton)

Simula un clic del ratón en la sesión remota. Establezca el parámetro en true para un clic izquierdo o en false para un clic derecho.

boolean enableMouseMode(boolean enabled)

Habilita o deshabilita el modo ratón.

boolean sendMouseEvent(MotionEvent motionEvent)

y

sendMouseEvent(MotionEvent motionEvent, IRemoteResult result)

Envía eventos de ratón a la sesión remota.

reconnect(String connectionToken)

Vuelve a conectar con la sesión después de una desconexión inesperada.

Este método se usa normalmente para gestionar una desconexión con reason=2200. Para reconectarse, su aplicación debe llamar a la openapi para obtener un nuevo token de conexión del teléfono en la nube y pasarlo a este método.

boolean setMediaStreamPlayer(MediaStreamPlayer player)

Reemplaza el motor multimedia predeterminado del SDK por un motor personalizado proporcionado por su aplicación. Debe llamar a este método antes de iniciar el streaming o después de que se desconecte la transmisión.

void setAlignStreamResolutionWithSurfaceSize(boolean aligned)

Habilita o deshabilita la alineación automática de la resolución de la transmisión con el tamaño del SurfaceView del cliente cuando inicia el streaming. Esta función está habilitada de forma predeterminada. Para teléfonos en la nube, se recomienda deshabilitarla.

void mute(boolean muted)

Habilita o deshabilita el modo silencioso.

void enableStatistics(boolean enabled)

Habilita o deshabilita la recopilación de datos de rendimiento.

mStreamView.getASPEngineDelegate().requestIFrame()

Solicita un fotograma clave.

En mStreamView.getASPEngineDelegate():

registerFileTransferListener(IFileTransferListener var1)

y

unregisterFileTransferListener(IFileTransferListener var1)

y

mStreamView.getASPEngineDelegate().uploadFiles(pathList, "/sdcard/Download/");

Gestiona la carga y descarga de archivos. Para conocer los detalles de implementación, consulte la aplicación de demostración.

En mStreamView.getASPEngineDelegate():

addDataChannel(DataChannel var1)

y

removeDataChannel(DataChannel var1)

Agrega o elimina un canal de datos personalizado para intercambiar información con la sesión remota. Para conocer los detalles de implementación, consulte la aplicación de demostración.

En mStreamView.getASPEngineDelegate():

addLyncChannel(LyncChannel var1)

y

removeLyncChannel(LyncChannel var1)

Agrega o elimina el canal para enviar comandos ADB. Para conocer los detalles de implementación, consulte AspAdbUtil en la aplicación de demostración.

void setToQualityFirst()

Establece el modo de prioridad de calidad. Este modo admite una tasa máxima de 30 fps y la calidad de imagen se configura en Alta. No es compatible con teléfonos en la nube.

void setToFpsFirst()

Establece el modo de prioridad de fluidez. Este modo admite una tasa máxima de 60 fps y la calidad de imagen se configura en Buena. No es compatible con teléfonos en la nube.

void setToCustomPicture(int fps, int quality);

Establece un modo personalizado que le permite definir la tasa de fotogramas y la calidad de imagen.

El parámetro fps acepta valores de 0 a 60. Un valor más alto produce un video más fluido.

El parámetro quality acepta valores de 0 a 4, donde 0 es sin pérdida, 1 es alta, 2 es buena, 3 es aceptable y 4 es automática. No es compatible con teléfonos en la nube.

En mStreamView.getASPEngineDelegate():

registerIMEListener, unregisterIMEListener, setImeType, enableRelativeMouse, etc.

No es compatible con teléfonos en la nube.

4. Parámetros

4.1 Config

Utilice estos parámetros para establecer una conexión.

Parámetro

Tipo

Descripción

StreamView.CONFIG_DESKTOP_ID

string

El identificador de la instancia. Este valor corresponde al ResourceId que devuelve la API DescribeUserResources.

StreamView.CONFIG_CONNECTION_TICKET

string

El ticket de autenticación de conexión. Obtenga este ticket llamando a la API GetConnectionTicket.

StreamView.CONFIG_PREFER_RTC_TRANSPORT

boolean

Habilita el canal RTC cuando se establece en true. Se recomienda esta configuración para un teléfono en la nube.

StreamView.CONFIG_ENABLE_VDAGENT_CHECK

boolean

Habilita una comprobación de disponibilidad de VDAgent durante la conexión cuando se establece en true. Se recomienda esta configuración para un teléfono en la nube.

StreamView.CONFIG_ENABLE_STATISTICS

boolean

Establézcalo en true para habilitar las estadísticas de rendimiento, las cuales se muestran superpuestas en la transmisión de video. Se recomienda esta configuración para un teléfono en la nube.

OSType

string

El tipo de sistema operativo. Debe establecerse en android para un teléfono en la nube.

4.2 StatisticsInfo

Datos de rendimiento

API

Tipo

Descripción

mReceiveFps

int

Tasa de fotogramas recibidos

mRenderFps

int

Tasa de fotogramas renderizados

mDownstreamBandwithMBPerSecond

double

Ancho de banda descendente

mUpstreamBandwithMBPerSecond

double

Ancho de banda ascendente

mP2pFullLinkageLatencyMS

long

Latencia de extremo a extremo (obsoleto)

mNetworkLatencyMS

long

RTT de red

mPingGatewayRttMS

long

RTT de ping

mLostRate

double

Tasa de pérdida de paquetes

mServerRenderLatencyMS

long

Latencia de renderizado en la nube

mServerEncoderLatencyMS

long

Latencia de codificación en la nube

mServerTotalLatencyMS

long

Latencia total en la nube

mTotalDownstreamBandwidth

long

Ancho de banda descendente total

mGuestCpuUsage

long

Uso de CPU del huésped

mStreamType

String

Protocolo de streaming

5. Tipos de enumeración

5.1 ScaleType

Especifica cómo se escala la imagen transmitida para ajustarse al StreamView.

Parámetro

Descripción

FILL_STREAM_VIEW

Estira la imagen transmitida para llenar todo el StreamView. Esta configuración no conserva la relación de aspecto original de la imagen, lo que puede distorsionarla si las relaciones de aspecto no coinciden.

FIT_STREAM_CONTENT

Escala la imagen transmitida para que encaje dentro del StreamView manteniendo su relación de aspecto original. Esto evita la distorsión, pero puede dejar áreas vacías si las relaciones de aspecto de la imagen y de la vista difieren.

5.1 SystemPermission

Especifica los permisos del sistema.

Parámetro

Descripción

RECORDAUDIO

Permite grabar audio.

6. Personalización de MediaStreamPlayer

Nota

No es obligatoria una implementación multimedia personalizada, ya que el SDK proporciona una de forma predeterminada.

6.1 Procesar datos multimedia

La implementación de com.aliyun.wuying.aspsdk.aspengine.MediaStreamPlayer permite que una aplicación use un motor multimedia personalizado para procesar los datos de streaming multimedia, los cuales constan principalmente de lo siguiente:

  • Datos de transmisión de video: una transmisión de video sin procesar compuesta principalmente por fotogramas comprimidos H.264/H.265.

  • Transmisión de imágenes adaptable: una transmisión de imágenes formada principalmente por mapas de bits.

  • Datos de audio descendentes: una transmisión de audio principalmente en formato Opus/PCM.

  • Datos del cursor: cuando el modo de ratón virtual está habilitado, la aplicación recibe datos de imagen y posición del cursor, lo que le permite renderizar de forma independiente un cursor virtual.

Una aplicación puede llamar a IASPEngine.setMediaStreamPlayer para configurar una implementación de motor multimedia personalizado en el SDK de Alibaba Cloud Workspace.

6.2 MediaStreamPlayer

MediaStreamPlayer es una clase abstracta que requiere que las aplicaciones implementen métodos globales de inicialización y limpieza, además de proporcionar una implementación personalizada para gestionar distintos tipos de datos multimedia:

image.png

Donde:

  • La interfaz IVideoStreamHandler sirve para gestionar los datos de transmisión de video.

  • La interfaz IAdaptiveGraphicStreamHandler sirve para gestionar los datos de transmisión de gráficos adaptables.

  • La interfaz IAudioPlaybackStreamHandler sirve para gestionar los datos de reproducción de audio.

  • La interfaz ICursorBitmap sirve para gestionar los datos del cursor.

Una aplicación puede implementar una o más de las interfaces anteriores. Luego, el SDK de Alibaba Cloud Workspace determina el tipo de streaming en la nube según las interfaces implementadas, de la siguiente manera:

  • Si la aplicación implementa tanto IVideoStreamHandler como IAdaptiveGraphicStreamHandler, el modo de streaming se establece en Mixto. En este modo, Alibaba Cloud Workspace cambia automáticamente entre la transmisión de gráficos adaptables y la transmisión de video.

  • Si la aplicación solo implementa IVideoStreamHandler, el modo de streaming se establece en Solo transmisión de video, y el servidor proporcionará únicamente una transmisión de video.

  • Si la aplicación solo implementa IAdaptiveGraphicStreamHandler, el modo de streaming se establece en Solo transmisión de imágenes, y el servidor proporcionará únicamente una transmisión de imágenes.

Para personalizar la forma en que el SDK gestiona los distintos tipos de datos multimedia, implemente los métodos onCreateXXXHandler en MediaStreamPlayer:

    @Override
    protected IVideoStreamHandler onCreateVideoStreamHandler() {
        return new VideoStreamHandler();
    }

    @Override
    protected IAdaptiveGraphicStreamHandler onCreateAdaptiveGraphicStreamHandler() {
        return null;
    }

    @Override
    protected IAudioPlaybackStreamHandler onCreateAudioPlaybackStreamHandler() {
        return new AudioPlaybackStreamHandler();
    }

    @Override
    protected ICursorBitmapHandler onCreateCursorBitmapHandler() {
        return null;
    }

En el ejemplo anterior, el motor multimedia personalizado implementa tanto IVideoStreamHandler como IAudioPlaybackStreamHandler. El método onCreateXXXHandler se ejecuta solo una vez por cada sesión de streaming.

Llamada al método principal:

image

6.2.1 initialize

Su aplicación implementa este método para inicializar globalmente el motor multimedia personalizado.

El sistema llama a este método una vez durante cada proceso de streaming.

public ErrorCode initialize()

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si se ejecuta correctamente, o un código de error si falla.

6.2.2 release

Libera todos los recursos globales asociados con el motor multimedia personalizado.

Se llama a este método una vez durante cada sesión de streaming.

public ErrorCode release()

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si se ejecuta correctamente, o un código de error si falla.

6.2.3 enableStatistics

Utilice este método para habilitar o deshabilitar la recopilación de estadísticas de rendimiento.

public void enableStatistics(boolean enabled)

Parámetros

Parámetro

Tipo

Descripción

enabled

boolean

true

false

6.2.4 onCreateVideoStreamHandler

Proporciona una implementación de motor multimedia para gestionar los datos de transmisión de video.

El SDK ejecuta este método una vez por cada transmisión.

public IVideoStreamHandler onCreateVideoStreamHandler()

Valor de retorno

Tipo

Descripción

IVideoStreamHandler

La implementación de motor multimedia que proporciona la aplicación para gestionar los datos de transmisión de video.

Devuelva null si la aplicación no proporciona una implementación. En este caso, el SDK descarta los datos de transmisión de video.

6.2.5 onCreateAdaptiveGraphicStreamHandler

Proporciona una implementación de motor multimedia para gestionar los datos de transmisión de gráficos adaptables.

El SDK llama a este método una vez por cada sesión de streaming.

public IAdaptiveGraphicStreamHandler onCreateAdaptiveGraphicStreamHandler()

Valor de retorno

Tipo

Descripción

IAdaptiveGraphicStreamHandler

La implementación de motor multimedia de su aplicación para gestionar los datos de transmisión de gráficos adaptables.

Si su aplicación no proporciona una implementación, devuelva null. En este caso, el SDK no procesa los datos de transmisión de gráficos.

6.2.6 onCreateAudioPlaybackStreamHandler

Proporciona una implementación de motor multimedia para procesar los datos de audio descendentes.

El SDK llama a este método una vez por cada sesión de streaming.

public IAudioPlaybackStreamHandler onCreateAudioPlaybackStreamHandler()

Valor de retorno

Tipo

Descripción

IAudioPlaybackStreamHandler

Una implementación de motor multimedia proporcionada por la aplicación que procesa los datos de audio descendentes.

Si la aplicación no proporciona ninguna implementación, devuelva null. En este caso, el SDK no procesa los datos de audio descendentes.

6.2.7 onCreateCursorBitmapHandler

Proporciona al SDK un motor multimedia para procesar los datos del cursor.

El SDK llama a este método una vez por cada sesión de streaming.

El SDK utiliza la implementación de interfaz devuelta únicamente en el modo de ratón virtual.

public ICursorBitmapHandler onCreateCursorBitmapHandler()

Valor de retorno

Tipo

Descripción

ICursorBitmapHandler

La implementación del motor multimedia para procesar los datos del cursor.

Devuelva null si su aplicación no procesa datos del cursor. En ese caso, el SDK no procesará dichos datos, ni siquiera en el modo de ratón virtual.

6.3 IVideoStreamHandler

Esta interfaz proporciona los métodos principales para gestionar flujos de video. El flujo de trabajo es el siguiente:

image

Cuando la aplicación pasa de primer plano a segundo plano, o viceversa, se destruye o se vuelve a crear el objeto Surface que se usa para renderizar. En estos casos, se llama repetidamente al método IVideoStreamHandler.setVideoSurface. Cuando se destruye el objeto Surface, el objeto surface que se pasa a setVideoSurface es null. Su aplicación debe gestionar las fallas del decodificador y del renderizador.

Al implementar el método IVideoStreamHandler.setEventHandler, la aplicación obtiene la interfaz de gestión de eventos que proporciona el SDK de Alibaba Cloud Workspace. La aplicación usa esta interfaz para notificar al SDK los eventos de procesamiento de video generados por su motor multimedia personalizado, principalmente con el fin de recopilar datos de rendimiento.

    @Override
    public void setEventHandler(EventHandler handler) {
        Log.i(TAG, "setEventHandler handler " + handler);
        VideoStreamEventHandler.getInstance().reset(handler);
    }

...
    
    public synchronized void onVideoFrameRendered() {
        VFrame frame = mVideoFrame.remove();
        if (mEnabled && mHandler != null) {
            Event event = new Event();
            event.type = EventType.RENDER_PERF_INFO;
            event.decodePerfInfo = new VDecodePerfInfo();
            event.renderPerfInfo = new VRenderPerfInfo();
            event.renderPerfInfo.frameId = frame.frameId;
            event.renderPerfInfo.sessionId = frame.sessionId;
            // Notifies the SDK that a video frame has been rendered. The SDK then uses the frameId to calculate the client-side end-to-end latency.
            mHandler.callback(event);
        }
    }

6.3.1 setEventHandler

Se llama cuando el SDK carga el motor multimedia personalizado. Proporciona un EventHandler para enviar eventos de procesamiento del flujo de video.

public void setEventHandler(EventHandler handler)

Parámetros

Parámetro

Tipo

Descripción

handler

EventHandler

Objeto proporcionado por el SDK de Alibaba Cloud Workspace. Su aplicación lo utiliza para enviar eventos de procesamiento del flujo de video al SDK.

6.3.2 addVideoTrack

Se llama cuando se crea un flujo de video.

Actualmente, solo puede existir un flujo de video por sesión de streaming.

ErrorCode addVideoTrack(int trackId, VProfile profile);

Parámetros

Parámetro

Tipo

Descripción

trackId

int

El identificador del flujo de video.

profile

VProfile

Información sobre el flujo de video.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.3.3 setVideoSurface

Se llama cuando cambia el estado del objeto Surface de renderizado de video.

ErrorCode setVideoSurface(int trackId, Surface surface);

Parámetros

Parámetro

Tipo

Descripción

trackId

int

El identificador del flujo de video.

surface

android.view.Surface

El objeto Surface de renderizado.

Este valor puede ser null cuando la aplicación pasa a segundo plano o se bloquea el dispositivo.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.3.4 playVideo

Su aplicación debe implementar este método. El SDK lo llama cuando un flujo de video está listo para reproducirse.

ErrorCode playVideo(int trackId);

Parámetros

Parámetro

Tipo

Descripción

trackId

int

El identificador del flujo de video.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.3.5 removeVideoTrack

Elimina el flujo de video especificado.

ErrorCode removeVideoTrack(int trackId);

Parámetros

Parámetro

Tipo

Descripción

trackId

int

El identificador del flujo de video.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.3.6 pushVideoFrame

Implemente este método en su aplicación. El SDK lo llama cuando recibe un nuevo fotograma de video.

ErrorCode pushVideoFrame(int trackId, VFrame frame);

Parámetros

Parámetro

Tipo

Descripción

trackId

int

El identificador del flujo de video.

frame

VFrame

El fotograma de video recibido.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.3.7 getVideoTracks

Devuelve información sobre todos los flujos de video que se están procesando actualmente.

HashMap<Integer, VProfile> getVideoTracks();

Valor de retorno

Tipo

Descripción

HashMap<Integer, VProfile>

Un HashMap que contiene información sobre todos los flujos de video en proceso.

6.3.8 release

La aplicación implementa este método. Se llama cuando se destruyen todos los flujos de video, lo que permite limpiar recursos.

ErrorCode release();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4 IAudioPlaybackStreamHandler

Esta interfaz proporciona métodos para gestionar los datos del flujo de audio. El flujo de trabajo es el siguiente:

image

6.4.1 initAudio

Se llama cuando se crea un canal de audio.

ErrorCode initAudio();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4.2 deInitAudio

Se llama cuando se destruye un canal de audio.

ErrorCode deInitAudio();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4.3 startAudioPlayback

Se llama antes de que el teléfono en la nube comience a enviar el flujo de audio.

ErrorCode startAudioPlayback();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4.4 stopAudioPlayback

Su aplicación implementa este método. El SDK lo llama cuando el teléfono en la nube deja de enviar el flujo de audio.

ErrorCode stopAudioPlayback();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4.5 pushAudioPlaybackFrame

Su aplicación implementa este método. El SDK lo llama cuando recibe un nuevo fotograma de audio descendente.

ErrorCode pushAudioPlaybackFrame(AFrame pbData);

Parámetros

Parámetro

Tipo

Descripción

pbData

AFrame

El fotograma de audio descendente recibido.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4.6 updateAudioPlaybackVol

Se llama cuando cambia el volumen del sistema del teléfono en la nube.

ErrorCode updateAudioPlaybackVol(int volume);

Parámetros

Parámetro

Tipo

Descripción

volume

int

El valor oscila entre 0 (silenciado) y USHRT_MAX.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4.7 updateAudioPlaybackMute

Se llama cuando se silencia o se reactiva el audio del teléfono en la nube.

ErrorCode updateAudioPlaybackMute(int mute);

Parámetros

Parámetro

Tipo

Descripción

mute

int

Indica el estado de silencio. El valor 1 significa que el teléfono en la nube está silenciado, mientras que 0 indica que el audio está activado.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.4.8 release

La aplicación implementa este método. Se llama cuando se destruye un canal de audio para permitir la limpieza de recursos.

ErrorCode release();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.5 IAdaptiveGraphicStreamHandler

Esta interfaz proporciona métodos para procesar los datos del flujo de imágenes. El flujo de trabajo es el siguiente:

image

La aplicación recibe los fotogramas de imagen como mapas de bits ARGB8888.

Cada sesión de streaming admite un máximo de un flujo de imágenes.

6.5.1 setAdaptiveGraphicSurface

Se llama cuando cambia el estado del objeto Surface utilizado para renderizar imágenes.

ErrorCode setAdaptiveGraphicSurface(Surface surface);

Parámetros

Parámetro

Tipo

Descripción

surface

android.view.Surface

El objeto Surface para renderizar imágenes.

Este objeto puede ser nulo cuando la aplicación pasa a segundo plano o se bloquea la pantalla.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.5.2 invalidateAdaptiveGraphicSurface

Se llama cuando hay nuevos datos de fotogramas gráficos adaptativos disponibles.

ErrorCode invalidateAdaptiveGraphicSurface(Region region, byte[] buffer, BitmapFormat format);

Parámetros

Parámetro

Tipo

Descripción

region

Region

El área de dibujo del fotograma gráfico adaptativo.

buffer

byte[]

Los datos del fotograma gráfico adaptativo.

format

BitmapFormat

El formato del fotograma gráfico adaptativo. El valor predeterminado es ARGB8888.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.5.3 release

Se llama cuando se destruye el flujo de imágenes para limpiar recursos.

ErrorCode release();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.6 ICursorBitmapHandler

Esta interfaz define los métodos principales para gestionar los datos del cursor. Para renderizar la imagen del cursor en el modo de ratón virtual, la aplicación debe proporcionar al SDK una implementación de esta interfaz. El flujo de trabajo principal es el siguiente:

image

6.6.1 setCursorBitmap

Se llama cuando cambia el gráfico del cursor en el teléfono en la nube.

ErrorCode setCursorBitmap(CursorBitmap bitmap);

Parámetros

Parámetro

Tipo

Descripción

bitmap

CursorBitmap

Los datos del gráfico del cursor provenientes del teléfono en la nube.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.6.2 unsetCursorBitmap

Se llama cuando se oculta el cursor en el teléfono en la nube.

ErrorCode unsetCursorBitmap();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.6.3 setCursorPosition

Establece la posición del cursor en el teléfono en la nube.

ErrorCode setCursorPosition(float x, float y);

Parámetros

Parámetro

Tipo

Descripción

x

float

La coordenada x del cursor.

y

float

La coordenada y del cursor.

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

6.6.4 release

Se llama después de que se desconecta la conexión y desaparece el cursor, con el fin de limpiar recursos.

ErrorCode release();

Valor de retorno

Tipo

Descripción

ErrorCode

ErrorCode.OK si la operación se completa correctamente, o un código de error en caso de falla.

Códigos de error

Código de error

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

Módulo

Causa

Los códigos de error del 2 al 26 se relacionan 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

Las versiones no coinciden.

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

El ID de cliente no es 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 de 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 de la conexión.

25

Error al conectarse a %s.

ASP SDK

Error al validar el ticket. Este error también ocurre cuando se reutiliza el ticket de una sesión finalizada.

26

Error en el handshake de xquic.

ASP SDK

Error en el handshake de xquic.

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 celular en la nube ya está en uso.

1207

El ticket se invalidó porque se reinició 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 máquina virtual no es válida.

ASP SDK

1202

Ocurrió un error interno de administración.

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 los 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 de Android al presionar el botón Inicio.

2002

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

ASP SDK

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

2003

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

ASP SDK

El celular en la nube se apagó o se reinició, normalmente 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 que configuró el administrador.

2006

El administrador revocó su permiso para usar este celular 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 preemptive a collaborative, o de collaborative a preemptive.

2100

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

ASP SDK

Una directiva 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

Una directiva deniega el acceso al portapapeles desde el cliente local hacia la instancia remota.

2200

%s intenta reconectarse...

ASP SDK

La conexión se perdió por un problema de red y el ASP SDK intenta reconectarse.

2201

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

ASP SDK

La conexión se perdió por un problema de red. El 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 del 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 celular en la nube.

2212

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

ASP SDK

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

2220

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

ASP SDK

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

2240

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

ASP SDK

2300

La conexión falló porque la aplicación envió un parámetro no válido.

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 se rechazó.

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 porque el UUID no coincide.

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 escuche en el puerto 5912.

stream gateway

2511

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

stream gateway

2512

Falló la validación del token del stream gateway.

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 fallidos 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 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 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

8. Preguntas frecuentes

Reiniciar un celular en la nube

Para reiniciar un celular en la nube, llame a la API RebootAndroidInstancesInGroup. Esta acción desconecta temporalmente al cliente del celular en la nube. Una vez que finalice el reinicio, deberá reconectarse desde el cliente.

Maven público

Actualmente no se admite el hosting público de Maven. Para integrar el SDK, cargue la biblioteca AAR en su propio repositorio de Maven.

Comandos comunes de ADB

Función

Comando

Botón Atrás

input keyevent KEYCODE_BACK

Botón Inicio

input keyevent KEYCODE_HOME

Cambiar 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 la barra de navegación

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

Mostrar la barra de navegación

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

Captura de pantalla

screencap -p /sdcard/Download/abc.png