Cloud Phone：Android SDK

1.1 Memperoleh SDK dan demo

dependencies {
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    // INI configuration parsing library for aspengine-sdk
    implementation 'org.ini4j:ini4j:0.5.4'
    // Dependency for 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 Proses integrasi

2.1 Inisialisasi instans 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 Membuat sesi

Untuk informasi tentang nilai valid untuk mConfigs, lihat 4.1 Config.

mStreamView.start(mConfigs);

2.3 Putuskan dari sesi

mStreamView.stop();

2.4 Hapus instance StreamView

mStreamView.dispose();
mStreamView = null;

2.5 Mode Multi-StreamView

Mode ini mendukung peralihan tampilan aliran tunggal secara mulus antara beberapa instans View. Untuk mengimplementasikan fitur ini, ikuti langkah-langkah berikut:

1. Definisikan dan inisialisasi objek StreamView seperti yang dijelaskan pada bagian 2.1.

2. Gunakan IAspEngine untuk membuat koneksi, menggunakan parameter yang konsisten dengan definisi Config pada bagian 4.1.

   IASPEngine engine = mBuilder.enableRTC(true).build(context);
   //Enable statistics collection
   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. Bind IAspEngine ke instans StreamView. Pemanggilan ini akan memulai rendering aliran pada View yang ditentukan.

   mStreamView.bindASPEngine(engine);

4. Untuk beralih tampilan, bind IAspEngine ke instans StreamView yang berbeda. Hal ini memungkinkan View baru mengambil alih rendering aliran.

   mStreamView.resumeASPEngine();

Untuk implementasi lengkap, silakan merujuk ke aplikasi demo yang disediakan.

2.6 Petunjuk callback

Kode Contoh untuk Pendaftaran dan Pembatalan Callback:

// Dengarkan callback koneksi.
mStreamView.getASPEngineDelegate().registerASPEngineListener(IASPEngineListener var1);
mStreamView.getASPEngineDelegate().unregisterASPEngineListener(IASPEngineListener var1);
// Dengarkan callback data performa.
mStreamView.getASPEngineDelegate().registerStatisticsListener(IStatisticsListener var1);
mStreamView.getASPEngineDelegate().unregisterStatisticsListener(IStatisticsListener var1);
// Dengarkan permintaan izin sistem.
mStreamView.registerSystemPermissionListener(IRequestSystemPermissionListener listener);
mStreamView.unregisterSystemPermissionListener(IRequestSystemPermissionListener listener);

6.2.1 initialize

Metode ini diimplementasikan oleh aplikasi dan dapat digunakan untuk melaksanakan inisialisasi global terkait mesin media kustom.

Metode ini dieksekusi satu kali dalam setiap proses streaming.

public ErrorCode initialize()

Nilai Pengembalian:

6.2.2 release

Metode ini diimplementasikan oleh aplikasi dan dapat digunakan untuk menjalankan tugas pelepasan global terkait mesin media kustom.

Metode ini dieksekusi satu kali dalam setiap proses streaming.

public ErrorCode release()

Nilai Pengembalian:

6.2.3 enableStatistics

Metode ini diimplementasikan oleh aplikasi dan dapat digunakan untuk mengaktifkan atau menonaktifkan pengumpulan statistik performa.

public void enableStatistics(boolean enabled)

Parameter:

6.2.4 onCreateVideoStreamHandler

Metode ini diimplementasikan oleh aplikasi dan digunakan untuk menyediakan SDK dengan implementasi mesin media guna menangani data aliran video.

Metode ini dieksekusi satu kali dalam setiap proses streaming.

public IVideoStreamHandler onCreateVideoStreamHandler()

Nilai Pengembalian:

6.2.5 onCreateAdaptiveGraphicStreamHandler

Metode ini diimplementasikan oleh aplikasi dan digunakan untuk menyediakan SDK dengan implementasi mesin media guna menangani data aliran grafik adaptif.

Metode ini dieksekusi satu kali dalam setiap proses streaming.

public IAdaptiveGraphicStreamHandler onCreatAdaptiveGraphicStreamHandler()

Nilai Pengembalian:

6.2.6 onCreateAudioPlaybackStreamHandler

Metode ini diimplementasikan oleh aplikasi dan digunakan untuk menyediakan SDK dengan implementasi mesin media guna menangani data downstream audio.

Metode ini dieksekusi satu kali dalam setiap proses streaming.

public IAudioPlaybackStreamHandler onCreatAudioPlaybackStreamHandler()

Nilai Pengembalian:

6.2.7 onCreateCursorBitmapHandler

Metode ini diimplementasikan oleh aplikasi dan digunakan untuk menyediakan SDK dengan implementasi mesin media guna menangani data kursor.

Metode ini dijalankan satu kali dalam setiap proses streaming.

Antarmuka yang disediakan oleh metode ini hanya digunakan ketika mode mouse virtual diaktifkan.

public ICursorBitmapHandler onCreatCursorBitmapHandler()

Nilai Pengembalian:

6.3.1 setEventHandler

Metode ini diimplementasikan oleh aplikasi. Saat mesin media kustom dimuat oleh Alibaba Cloud Workspace SDK, SDK menggunakan metode ini untuk memberikan handler event kepada aplikasi Anda. Aplikasi dapat menggunakan handler ini untuk mengirimkan event pemrosesan aliran video.

public void setEventHandler(EventHandler handler)

Parameter:

6.3.2 addVideoTrack

Metode ini diimplementasikan oleh aplikasi dan memberi tahu aplikasi Anda saat aliran video dibuat.

Saat ini, hanya satu aliran video yang dapat aktif dalam satu sesi streaming pada satu waktu.

ErrorCode addVideoTrack(int trackId, VProfile profile);

Parameter:

Nilai Pengembalian:

6.3.3 setVideoSurface

Metode ini diimplementasikan oleh aplikasi. Ini memberi tahu aplikasi Anda saat status instance Surface yang digunakan untuk rendering video berubah.

ErrorCode setVideoSurface(int trackId, Surface surface);

Parameter:

Nilai Pengembalian:

6.3.4 playVideo

Metode ini diimplementasikan oleh aplikasi. Ini memberi tahu aplikasi Anda saat aliran video siap.

ErrorCode playVideo(int trackId);

Parameter:

Nilai Pengembalian:

6.3.5 removeVideoTrack

Metode ini diimplementasikan oleh aplikasi. Ini memberi tahu aplikasi Anda saat aliran video dihancurkan.

ErrorCode removeVideoTrack(int trackId);

Parameter:

Nilai Pengembalian:

6.3.6 pushVideoFrame

Metode ini diimplementasikan oleh aplikasi. Ini memberi tahu aplikasi Anda saat frame video baru diterima.

ErrorCode setVideoSurface(int trackId, Surface surface);

Parameter:

Nilai Pengembalian:

6.3.7 getVideoTracks

Metode ini diimplementasikan oleh aplikasi. SDK menggunakannya untuk mengambil informasi tentang aliran video yang sedang diproses oleh aplikasi Anda.

HashMap<Integer, VProfile> getVideoTracks();

Nilai Pengembalian:

6.3.8 release

Metode ini diimplementasikan oleh aplikasi. SDK menggunakannya untuk memberi tahu aplikasi Anda untuk melakukan tindakan pembersihan saat semua aliran video dihancurkan.

ErrorCode release();

Nilai Pengembalian:

6.4.1 initAudio

Metode ini diimplementasikan oleh aplikasi. Saat saluran audio dibuat dalam SDK, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode initAudio();

Nilai Pengembalian:

6.4.2 deInitAudio

Metode ini diimplementasikan oleh aplikasi. Saat saluran audio dihancurkan dalam SDK, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode deInitAudio();

Nilai Pengembalian:

6.4.3 startAudioPlayback

Metode ini diimplementasikan oleh aplikasi. Saat telepon cloud akan mulai streaming audio, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode startAudioPlayback();

Nilai Pengembalian:

6.4.4 stopAudioPlayback

Metode ini diimplementasikan oleh aplikasi. Saat telepon cloud menghentikan streaming audio, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode stopAudioPlayback();

Nilai Pengembalian:

6.4.5 pushAudioPlaybackFrame

Metode ini diimplementasikan oleh aplikasi. Saat frame audio downstream baru diterima, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode pushAudioPlaybackFrame(AFrame pbData);

Parameter:

Nilai Pengembalian:

6.4.6 updateAudioPlaybackVol

Metode ini diimplementasikan oleh aplikasi. Saat volume sistem di telepon cloud berubah, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode updateAudioPlaybackVol(int volume);

Parameter:

Nilai Pengembalian:

6.4.7 updateAudioPlaybackMute

Metode ini diimplementasikan oleh aplikasi. Saat telepon cloud dibisukan atau tidak dibisukan, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode updateAudioPlaybackMute(int mute);

Parameter:

Nilai Pengembalian:

6.4.8 release

Metode ini diimplementasikan oleh aplikasi. SDK menggunakannya untuk memberi tahu aplikasi Anda untuk melakukan tindakan pembersihan saat saluran audio dihancurkan.

ErrorCode release();

Nilai Pengembalian:

6.5.1 setAdaptiveGraphicSurface

Metode ini diimplementasikan oleh aplikasi. Ini memberi tahu aplikasi Anda saat status instance Surface yang digunakan untuk rendering gambar berubah.

ErrorCode setAdaptiveGraphicSurface(Surface surface);

Parameter:

Nilai Pengembalian:

6.5.2 invalidateAdaptiveGraphicSurface

Metode ini diimplementasikan oleh aplikasi. Ini memberi tahu aplikasi Anda saat frame grafik adaptif baru diterima.

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

Parameter:

Nilai Pengembalian:

6.5.3 release

Metode ini diimplementasikan oleh aplikasi. SDK menggunakannya untuk memberi tahu aplikasi Anda untuk melakukan tindakan pembersihan saat semua aliran grafik adaptif dihancurkan.

ErrorCode release();

Nilai Pengembalian:

6.6.1 setCursorBitmap

Metode ini diimplementasikan oleh aplikasi. Saat grafik kursor di telepon cloud berubah, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode setCursorBitmap(CursorBitmap bitmap);

Parameter:

Nilai Pengembalian:

6.6.2 unsetCursorBitmap

Metode ini diimplementasikan oleh aplikasi. Saat kursor di telepon cloud disembunyikan, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode unsetCursorBitmap();

Nilai Pengembalian:

6.6.3 setCursorPosition

Metode ini diimplementasikan oleh aplikasi. Saat posisi kursor di telepon cloud berubah, aplikasi Anda diberi tahu melalui metode ini.

ErrorCode setCursorPosition(float x, float y);

Parameter:

Nilai Pengembalian:

6.6.4 release

Metode ini diimplementasikan oleh aplikasi. SDK menggunakannya untuk memberi tahu aplikasi Anda untuk melakukan tindakan pembersihan saat koneksi diputus dan tampilan kursor dibatalkan.

ErrorCode release();

Nilai Pengembalian: