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"/>

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

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 マルチ StreamView モード

このモードでは、1 つのストリームを複数の 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. StreamView 上でレンダリングを再開します。この呼び出しは、View にストリームのレンダリングを再開するように指示します。

   mStreamView.resumeASPEngine();

詳細については、デモアプリケーションの実装をご参照ください。

2.6 コールバック

コールバックの登録と登録解除のサンプルコード：

// 接続コールバックをリッスンします。
mStreamView.getASPEngineDelegate().registerASPEngineListener(IASPEngineListener listener);
mStreamView.getASPEngineDelegate().unregisterASPEngineListener(IASPEngineListener listener);
// パフォーマンスデータコールバックをリッスンします。
mStreamView.getASPEngineDelegate().registerStatisticsListener(IStatisticsListener listener);
mStreamView.getASPEngineDelegate().unregisterStatisticsListener(IStatisticsListener listener);
// システム権限リクエストをリッスンします。
mStreamView.registerSystemPermissionListener(IRequestSystemPermissionListener listener);
mStreamView.unregisterSystemPermissionListener(IRequestSystemPermissionListener listener);

6.2.1 initialize

アプリケーションはこのメソッドを実装して、カスタムメディアエンジンをグローバルに初期化します。

システムは、各ストリーミングプロセス中にこのメソッドを 1 回呼び出します。

public ErrorCode initialize()

戻り値

6.2.2 release

カスタムメディアエンジンに関連付けられているすべてのグローバルリソースを解放します。

このメソッドは、各ストリーミングセッション中に 1 回呼び出されます。

public ErrorCode release()

戻り値

6.2.3 enableStatistics

このメソッドを使用して、パフォーマンス統計の収集を有効または無効にします。

public void enableStatistics(boolean enabled)

パラメーター

6.2.4 onCreateVideoStreamHandler

ビデオストリームデータを処理するためのメディアエンジン実装を提供します。

SDK は、ストリームごとにこのメソッドを 1 回実行します。

public IVideoStreamHandler onCreateVideoStreamHandler()

戻り値

6.2.5 onCreateAdaptiveGraphicStreamHandler

アダプティブグラフィックストリームデータを処理するためのメディアエンジン実装を提供します。

SDK は、ストリーミングセッションごとにこのメソッドを 1 回呼び出します。

public IAdaptiveGraphicStreamHandler onCreateAdaptiveGraphicStreamHandler()

戻り値

6.2.6 onCreateAudioPlaybackStreamHandler

音声ダウンストリームデータを処理するためのメディアエンジン実装を提供します。

SDK は、ストリーミングセッションごとにこのメソッドを 1 回呼び出します。

public IAudioPlaybackStreamHandler onCreateAudioPlaybackStreamHandler()

戻り値

6.2.7 onCreateCursorBitmapHandler

カーソルデータ処理のためのメディアエンジンを SDK に提供します。

SDK は、ストリーミングセッションごとにこのメソッドを 1 回呼び出します。

SDK は、返されたインターフェイス実装を仮想マウスモードでのみ使用します。

public ICursorBitmapHandler onCreateCursorBitmapHandler()

戻り値

6.3.1 setEventHandler

SDK がカスタムメディアエンジンをロードするときに呼び出されます。ビデオストリーム処理イベントを送信するための EventHandler を提供します。

public void setEventHandler(EventHandler handler)

パラメーター

6.3.2 addVideoTrack

ビデオストリームが作成されるときに呼び出されます。

現在、単一のストリーミングセッションには 1 つのビデオストリームしか存在できません。

ErrorCode addVideoTrack(int trackId, VProfile profile);

パラメーター

戻り値

6.3.3 setVideoSurface

ビデオレンダリング Surface の状態が変化したときに呼び出されます。

ErrorCode setVideoSurface(int trackId, Surface surface);

パラメーター

戻り値

6.3.4 playVideo

アプリケーションはこのメソッドを実装する必要があります。SDK は、ビデオストリームが再生準備完了になったときに呼び出します。

ErrorCode playVideo(int trackId);

パラメーター

戻り値

6.3.5 removeVideoTrack

指定されたビデオストリームを削除します。

ErrorCode removeVideoTrack(int trackId);

パラメーター

戻り値

6.3.6 pushVideoFrame

アプリケーションでこのメソッドを実装します。SDK は、新しいビデオフレームを受信したときにこのメソッドを呼び出します。

ErrorCode pushVideoFrame(int trackId, VFrame frame);

パラメーター

戻り値

6.3.7 getVideoTracks

現在処理中のすべてのビデオストリームに関する情報を返します。

HashMap<Integer, VProfile> getVideoTracks();

戻り値

6.3.8 release

このメソッドはアプリケーションによって実装されます。すべてのビデオストリームが破棄されたときに呼び出され、アプリケーションがクリーンアップを実行できるようにします。

ErrorCode release();

戻り値

6.4.1 initAudio

音声チャネルが作成されたときに呼び出されます。

ErrorCode initAudio();

戻り値

6.4.2 deInitAudio

音声チャネルが破棄されたときに呼び出されます。

ErrorCode deInitAudio();

戻り値

6.4.3 startAudioPlayback

クラウドフォンが音声ストリームの送信を開始する前に呼び出されます。

ErrorCode startAudioPlayback();

戻り値

6.4.4 stopAudioPlayback

アプリケーションはこのメソッドを実装します。SDK は、クラウドフォンが音声ストリームの送信を停止したときにこのメソッドを呼び出します。

ErrorCode stopAudioPlayback();

戻り値

6.4.5 pushAudioPlaybackFrame

アプリケーションはこのメソッドを実装します。SDK は、新しいダウンストリーム音声フレームが受信されたときにこのメソッドを呼び出します。

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

戻り値