Android SDK

1.1 获取SDK和DEMO

dependencies {
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    // aspengine-sdk依赖的ini配置解析库
    implementation 'org.ini4j:ini4j:0.5.4'
}

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.VIBRATE"/>

1.2 对接流程

1.3 最佳实践

方案详见无影云手机快速集成最佳实践。 云手机集成的总体方案如下图所示

有多种登录方式，获取集成SDK所需要的连接云手机Ticket凭证，流程图为：

具体集成代码可以参考生命周期接口的参考代码。

2.1 初始化创建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 建立连接

mConfigs取值参考4.1 Config

mStreamView.start(mConfigs);

2.3 断开连接

mStreamView.stop();

2.4 销毁实例StreamView

mStreamView.dispose();
mStreamView = null;

2.5 多StreamView模式

此模式支持一个串流在多个View之间无缝切换显示。可按照如下步骤来实现：

1. 参照2.1 定义并初始化StreamView

2. 使用IAspEngine来建立连接，参数与4.1 Config定义一致

   IASPEngine engine = mBuilder.enableRTC(true).build(context);
   //开启数据统计
   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. 将StreamView与IAspEngine绑定（该接口会将串流在当前View进行渲染）

   mStreamView.bindASPEngine(engine);

4. 恢复StreamView与IAspEngine绑定（该接口会让View重新接管串流进行渲染）

   mStreamView.resumeASPEngine();

更多细节请参考DEMO的实现。

2.6 回调说明

注册与反注册回调代码示例：

//监听连接回调
mStreamView.getASPEngineDelegate().registerASPEngineListener(IASPEngineListener var1);
mStreamView.getASPEngineDelegate().unregisterASPEngineListener(IASPEngineListener var1);
//监听性能数据回调
mStreamView.getASPEngineDelegate().registerStatisticsListener(IStatisticsListener var1);
mStreamView.getASPEngineDelegate().unregisterStatisticsListener(IStatisticsListener var1);
//监听申请系统权限
mStreamView.registerSystemPermissionListener(IRequestSystemPermissionListener listener);
mStreamView.unregisterSystemPermissionListener(IRequestSystemPermissionListener listener);

6.2.1 initialize

由应用程序实现该方法，可用于执行自定义媒体引擎相关的全局初始化动作。

该方法在每次串流过程中将被执行一次。

public ErrorCode initialize()

返回值：

6.2.2 release

由应用程序实现该方法，可用于执行自定义媒体引擎相关的全局释放动作。

该方法在每次串流过程中将被执行一次。

public ErrorCode release()

返回值：

6.2.3 enableStatistics

由应用程序实现该方法，可用于激活/关闭性能统计数据采集。

public void enableStatistics(boolean enabled)

参数：

6.2.4 onCreateVideoStreamHandler

由应用程序实现该方法，用于向SDK提供处理视频流数据的媒体引擎实现。

该方法在每次串流过程中将被执行一次。

public IVideoStreamHandler onCreateVideoStreamHandler()

返回值：

6.2.5 onCreateAdaptiveGraphicStreamHandler

由应用程序实现该方法，用于向SDK提供处理自适应图片流数据的媒体引擎实现。

该方法在每次串流过程中将被执行一次。

public IAdaptiveGraphicStreamHandler onCreatAdaptiveGraphicStreamHandler()

返回值：

6.2.6 onCreateAudioPlaybackStreamHandler

由应用程序实现该方法，用于向SDK提供处理音频下行数据的媒体引擎实现。

该方法在每次串流过程中将被执行一次。

public IAudioPlaybackStreamHandler onCreatAudioPlaybackStreamHandler()

返回值：

6.2.7 onCreateCursorBitmapHandler

由应用程序实现该方法，用于向SDK提供处理光标数据的媒体引擎实现。

该方法在每次串流过程中将被执行一次。

通过该方法提供的接口实现仅在虚拟鼠标模式激活时被使用。

public ICursorBitmapHandler onCreatCursorBitmapHandler()

返回值：

6.3.1 setEventHandler

由应用程序实现该方法，当自定义媒体引擎被无影SDK加载时，SDK通过该方法向应用程序提供EventHandler，应用程序可通过该handler发送视频流处理事件。

public void setEventHandler(EventHandler handler)

参数：

6.3.2 addVideoTrack

由应用程序实现该方法，当一路视频流创建时，通过该方法通知应用程序。

目前一次串流过程中最多只存在一路视频。

ErrorCode addVideoTrack(int trackId, VProfile profile);

参数：

返回值：

6.3.3 setVideoSurface

由应用程序实现该方法，当用于渲染视频的Surface状态发生变化时，通过该方法通知应用程序。

ErrorCode setVideoSurface(int trackId, Surface surface);

参数：

返回值：

6.3.4 playVideo

由应用程序实现该方法，当用视频流准备就绪时，通过该方法通知应用程序。

ErrorCode playVideo(int trackId);

参数：

返回值：

6.3.5 removeVideoTrack

由应用程序实现该方法，当视频流被销毁时，通过该方法通知应用程序。

ErrorCode removeVideoTrack(int trackId);

参数：

返回值：

6.3.6 pushVideoFrame

由应用程序实现该方法，当用于接收到新的视频帧时，通过该方法通知应用程序。

ErrorCode setVideoSurface(int trackId, Surface surface);

参数：

返回值：

6.3.7 getVideoTracks

由应用程序实现该方法，SDK通过该方法从应用程序获取当前正在处理所有视频流信息。

HashMap<Integer, VProfile> getVideoTracks();

返回值：

6.3.8 release

由应用程序实现该方法，当所有的视频流被销毁时，通过该方法通知应用程序执行清理动作。

ErrorCode release();

返回值：

6.4.1 initAudio

由应用程序实现该方法，当SDK内的音频通道创建时，通过该方法通知应用程序。

ErrorCode initAudio();

返回值：

6.4.2 deInitAudio

由应用程序实现该方法，当SDK内的音频通道被销毁时，通过该方法通知应用程序。

ErrorCode deInitAudio();

返回值：

6.4.3 startAudioPlayback

由应用程序实现该方法，当云手机将要开始下发音频流时，通过该方法通知应用程序。

ErrorCode startAudioPlayback();

返回值：

6.4.4 stopAudioPlayback

由应用程序实现该方法，当云手机停止下发音频流时，通过该方法通知应用程序。

ErrorCode stopAudioPlayback();

返回值：

6.4.5 pushAudioPlaybackFrame

由应用程序实现该方法，当接收到新的下行音频帧时，通过该方法通知应用程序。

ErrorCode pushAudioPlaybackFrame(AFrame pbData);

参数：

返回值：

6.4.6 updateAudioPlaybackVol

由应用程序实现该方法，当云手机里的系统音量大小发生变化时，通过该方法通知应用程序。

ErrorCode updateAudioPlaybackVol(int volume);

参数：

返回值：

6.4.7 updateAudioPlaybackMute

由应用程序实现该方法，当云手机被静音/解除静音时，通过该方法通知应用程序。

ErrorCode updateAudioPlaybackMute(int mute);

参数：

返回值：

6.4.8 release

由应用程序实现该方法，当音频通道被销毁时，通过该方法通知应用程序执行清理动作。

ErrorCode release();

返回值：

6.5.1 setAdaptiveGraphicSurface

由应用程序实现该方法，当用于渲染图片的Surface状态发生变化时，通过该方法通知应用程序

ErrorCode setAdaptiveGraphicSurface(Surface surface);

参数：

返回值：

6.5.2 invalidateAdaptiveGraphicSurface

由应用程序实现该方法，当用于接收到新的图片帧数据时，通过该方法通知应用程序

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

参数：

返回值：

6.5.3 release

由应用程序实现该方法，当图片流被销毁时，通过该方法通知应用程序执行清理动作。

ErrorCode release();

返回值：

6.6.1 setCursorBitmap

由应用程序实现该方法，当云手机里的光标形状发生变化时，通过该方法通知应用程序。

ErrorCode setCursorBitmap(CursorBitmap bitmap);

参数：

返回值：

6.6.2 unsetCursorBitmap

由应用程序实现该方法，当云手机里的光标被隐藏时，通过该方法通知应用程序。

ErrorCode unsetCursorBitmap();

返回值：

6.6.3 setCursorPosition

由应用程序实现该方法，当云手机里的光标形状生变化时，通过该方法通知应用程序。

ErrorCode setCursorPosition(float x, float y);

参数：

返回值：

6.6.4 release

由应用程序实现该方法，当连接断开，取消光标显示时，通过该方法通知应用程序执行清理动作。

ErrorCode release();

返回值：