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
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.gradledel 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
1.3 Mejores prácticas
Consulte Best practices for integrating Cloud Phone.
Existen varios métodos de inicio de sesión disponibles para obtener el ticket de conexión durante la integración del SDK.
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:
Defina e inicialice las instancias de
StreamViewcomo se describe en la Sección 2.1.-
Utilice
IAspEnginepara establecer una conexión. Los parámetros deben coincidir con la definición deConfigde 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); -
Vincule
IAspEnginea unStreamView. Esta llamada renderiza la transmisión en laViewespecificada.mStreamView.bindASPEngine(engine); -
Reanude la renderización en un
StreamView. Esta llamada indica a laViewque 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 |
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 |
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 No se recomienda establecer este parámetro en |
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 |
scaleStreamVideo(ScaleType scaleType) | Especifica el comportamiento de escalado para la transmisión de video. Para conocer los valores válidos de |
setVideoProfile(int width, int height, int fps, IRemoteResult result) | Establece la resolución de la transmisión de video. Actualmente, el parámetro |
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 |
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 |
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 |
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 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 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 addLyncChannel(LyncChannel var1) y removeLyncChannel(LyncChannel var1) | Agrega o elimina el canal para enviar comandos ADB. Para conocer los detalles de implementación, consulte |
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 El parámetro |
En 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 |
|
|
string |
El identificador de la instancia. Este valor corresponde al |
|
|
string |
El ticket de autenticación de conexión. Obtenga este ticket llamando a la API |
|
|
boolean |
Habilita el canal RTC cuando se establece en |
|
|
boolean |
Habilita una comprobación de disponibilidad de VDAgent durante la conexión cuando se establece en |
|
|
boolean |
Establézcalo en |
|
|
string |
El tipo de sistema operativo. Debe establecerse en |
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
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:

Donde:
La interfaz
IVideoStreamHandlersirve para gestionar los datos de transmisión de video.La interfaz
IAdaptiveGraphicStreamHandlersirve para gestionar los datos de transmisión de gráficos adaptables.La interfaz
IAudioPlaybackStreamHandlersirve para gestionar los datos de reproducción de audio.La interfaz
ICursorBitmapsirve 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:
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 |
|
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 |
|
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 |
|
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 |
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 |
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 |
6.3 IVideoStreamHandler
Esta interfaz proporciona los métodos principales para gestionar flujos de video. El flujo de trabajo es el siguiente:
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 |
|
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 Este valor puede ser |
Valor de retorno
|
Tipo |
Descripción |
|
ErrorCode |
|
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 |
|
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 |
|
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 |
|
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 |
|
6.4 IAudioPlaybackStreamHandler
Esta interfaz proporciona métodos para gestionar los datos del flujo de audio. El flujo de trabajo es el siguiente:
6.4.1 initAudio
Se llama cuando se crea un canal de audio.
ErrorCode initAudio();
Valor de retorno
|
Tipo |
Descripción |
|
ErrorCode |
|
6.4.2 deInitAudio
Se llama cuando se destruye un canal de audio.
ErrorCode deInitAudio();
Valor de retorno
|
Tipo |
Descripción |
|
ErrorCode |
|
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 |
|
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 |
|
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 |
|
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 |
Valor de retorno
|
Tipo |
Descripción |
|
ErrorCode |
|
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 |
Valor de retorno
|
Tipo |
Descripción |
|
ErrorCode |
|
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 |
|
6.5 IAdaptiveGraphicStreamHandler
Esta interfaz proporciona métodos para procesar los datos del flujo de imágenes. El flujo de trabajo es el siguiente:
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 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 |
|
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 |
|
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 |
|
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:
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 |
|
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 |
|
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 |
|
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 |
|
Códigos de error
Código de error | Mensaje de error ( | 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 |