Cloud Phone：Android SDK

1.1 擷取SDK和DEMO

dependencies {
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    // aspengine-sdk依賴的ini配置解析庫
    implementation 'org.ini4j:ini4j:0.5.4'
    // 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'
}

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

1.2 對接流程

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();

傳回值：