Cloud Phone:Android SDK

1.1 SDK とデモを入手する

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 設定」をご参照ください。

mStreamView.start(mConfigs);

2.3 セッションから切断する

mStreamView.stop();

2.4 StreamView インスタンスを破棄する

mStreamView.dispose();
mStreamView = null;

2.5 Multi-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. IAspEngine を StreamView インスタンスにバインドします。この呼び出しにより、指定された View でストリームのレンダリングが開始されます。

   mStreamView.bindASPEngine(engine);

4. 表示を切り替えるには、IAspEngine を別の StreamView インスタンスにバインドします。これにより、新しい View がストリームのレンダリングを引き継ぐことができます。

   mStreamView.resumeASPEngine();

完全な実装については、提供されているデモアプリケーションをご参照ください。

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 リリース

このメソッドはアプリによって実装され、カスタムメディアエンジンに関連するグローバル リリース タスクを実行するために使用できます。

このメソッドは、各ストリーミングプロセスで一度実行されます。

public ErrorCode release() // 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

このメソッドはアプリによって実装されます。Alibaba Cloud Workspace SDK によってカスタムメディアエンジンがロードされると、SDK はこのメソッドを使用してアプリにイベントハンドラを提供します。アプリはこのハンドラを使用して、ビデオストリーム処理イベントを送信できます。

public void setEventHandler(EventHandler handler) // SDK から提供されるハンドラ。アプリは、このハンドラを使用して SDK にビデオストリーム処理イベントを送信できます。

パラメータ:

6.3.2 addVideoTrack

このメソッドはアプリによって実装されます。ビデオストリームが作成されたときにアプリに通知します。

現在、1回のストリーミングセッション中に存在できるビデオストリームは1つだけです。

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 リリース

このメソッドはアプリによって実装されます。 SDK は、すべてのビデオ ストリームが破棄されたときにクリーンアップ操作を実行するようにアプリに通知するために、このメソッドを使用します。

ErrorCode release(); // クリーンアップ操作を実行するためのメソッド

戻り値:

6.4.1 initAudio

このメソッドはアプリによって実装されます。 SDK 内にオーディオチャンネルが作成されると、このメソッドを介してアプリに通知されます。

ErrorCode initAudio();

戻り値：

6.4.2 deInitAudio

このメソッドは、アプリ側で実装します。SDK 内でオーディオチャンネルが破棄されると、このメソッドを通じてアプリに通知されます。

ErrorCode deInitAudio(); // オーディオの初期化を解除します。

戻り値:

6.4.3 startAudioPlayback

このメソッドはアプリによって実装されます。クラウドフォンが音声のストリーミングを開始しようとしているとき、アプリはこのメソッドによって通知されます。

ErrorCode startAudioPlayback(); // ErrorCode を返します。

戻り値：

6.4.4 stopAudioPlayback

このメソッドはアプリによって実装されます。クラウドフォンが音声のストリーミングを停止すると、アプリはこのメソッドを介して通知を受け取ります。

ErrorCode stopAudioPlayback(); // 音声再生を停止する

戻り値：

6.4.5 pushAudioPlaybackFrame

このメソッドはアプリによって実装されます。新しいダウンストリームオーディオフレームを受信すると、このメソッドを介してアプリに通知されます。

ErrorCode pushAudioPlaybackFrame(AFrame pbData); // 音声再生フレームをプッシュするエラーコード

パラメータ:

戻り値：

6.4.6 updateAudioPlaybackVol

このメソッドはアプリによって実装されます。クラウドフォンのシステム音量が変更されると、このメソッドを介してアプリに通知されます。

ErrorCode updateAudioPlaybackVol(int volume); // ErrorCode updateAudioPlaybackVol(int ボリューム);

パラメータ:

戻り値:

6.4.7 updateAudioPlaybackMute

このメソッドはアプリによって実装されます。クラウドフォンがミュートまたはミュート解除されると、このメソッドを介してアプリに通知されます。

ErrorCode updateAudioPlaybackMute(int mute);

パラメータ:

戻り値:

6.4.8 release

このメソッドはアプリによって実装されます。SDK は、オーディオ チャンネルが破棄されたときにクリーンアップ 操作を実行するようにアプリに通知するためにこれを使用します。

ErrorCode release(); // ErrorCode を返します

戻り値:

6.5.1 setAdaptiveGraphicSurface

このメソッドはアプリによって実装されます。 イメージレンダリングに使用される Surface インスタンスの状態が変化したときに、アプリに通知します。

ErrorCode setAdaptiveGraphicSurface(Surface surface);

パラメータ:

戻り値:

6.5.2 invalidateAdaptiveGraphicSurface

このメソッドはアプリによって実装されます。新しいアダプティブグラフィックフレームを受信したときにアプリに通知します。

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

パラメータ:

戻り値:

6.5.3 リリース

このメソッドはアプリによって実装されます。 SDK は、すべてのアダプティブ グラフィック ストリームが破棄されたときにクリーンアップ操作を実行するようにアプリに通知するために、このメソッドを使用します。

ErrorCode release(); // ErrorCode を返します

戻り値：

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 リリース

このメソッドはアプリによって実装されます。SDK はこれを使用して、接続が切断され、カーソル表示がキャンセルされたときにクリーンアップ操作を実行するようにアプリに通知します。

ErrorCode release(); // ErrorCode を解放します

戻り値：