ApsaraVideo Live:Gunakan Push SDK untuk Android

Daftarkan SDK

Untuk mendapatkan dan mengonfigurasi lisensi, integrasikan lisensi Push SDK.

Panggil API pendaftaran lisensi lebih awal dalam siklus hidup aplikasi Anda, sebelum menggunakan Push SDK untuk Android.

AlivcLiveBase.setListener(new AlivcLiveBaseListener() {
  @Override
  public void onLicenceCheck(AlivcLivePushConstants.AlivcLiveLicenseCheckResultCode result, String reason) {
    Log.e(TAG, "onLicenceCheck: " + result + ", " + reason);
  }
});
AlivcLiveBase.registerSDK();

• Gunakan kelas AlivcLiveBase untuk mengatur tingkat log, menentukan path log lokal, dan mendapatkan versi SDK.

• Anda harus memanggil metode registerSDK di AlivcLiveBase untuk mendaftarkan lisensi SDK.

• Implementasikan callback onLicenceCheck pada antarmuka AlivcLiveBase#setListener untuk memverifikasi konfigurasi lisensi secara asinkron.

  Catatan

  Callback ini hanya dipicu setelah Anda menginisialisasi instans pusher.

Ambil aliran kamera

1. Inisialisasi.

   Panggil metode init setelah mengonfigurasi parameter pengambilan aliran:

   AlivcLivePusher mAlivcLivePusher = new AlivcLivePusher();
   mAlivcLivePusher.init(mContext, mAlivcLivePushConfig);

   Catatan

   AlivcLivePusher tidak mendukung beberapa instans. Setiap panggilan init harus diikuti oleh panggilan destroy.

2. Daftarkan callback pratinjau.

   Panggil metode setLivePushInfoListener untuk mendaftarkan callback pratinjau:

   /**
    * Atur listener untuk notifikasi event pengambilan aliran.
    *
    * @param infoListener Listener notifikasi.
    */
   mAlivcLivePusher.setLivePushInfoListener(new AlivcLivePushInfoListener() {
       @Override
       public void onPreviewStarted(AlivcLivePusher pusher) {
           // Notifikasi bahwa pratinjau telah dimulai.
       }
       // Metode override lainnya
       //....
       //....
   });

3. Mulai pratinjau.

   Mulai pratinjau dengan meneruskan SurfaceView untuk pratinjau kamera:

   mAlivcLivePusher.startPreview(mSurfaceView); // Memulai pratinjau. Anda juga dapat memanggil metode asinkron startPreviewAsync sesuai kebutuhan.

4. Mulai pengambilan aliran.

   Tambahkan kode berikut di dalam metode callback onPreviewStarted.

   mAlivcLivePusher.startPush(mPushUrl);

   Catatan

   • URL ingest untuk RTMP dan RTS (artc://) didukung. Untuk mendapatkan URL, lihat Hasilkan URL ingest dan streaming.

   • ApsaraVideo Live menolak permintaan pengambilan aliran bersamaan ke URL yang sama.

/* Panggil untuk menjeda aliran yang sedang diambil. Setelah dijeda, pratinjau video dan pengambilan aliran video ditahan pada frame terakhir, sedangkan pengambilan aliran audio tetap berlanjut. */
mAlivcLivePusher.pause();
/* Panggil untuk melanjutkan aliran yang dijeda. Setelah dilanjutkan, pratinjau audio dan video serta pengambilan aliran kembali normal. */
mAlivcLivePusher.resume();
/* Panggil untuk menghentikan aliran yang sedang diambil. Setelah selesai, pengambilan aliran berhenti. */
mAlivcLivePusher.stopPush();
/* Panggil untuk menghentikan pratinjau saja saat berada dalam status pratinjau. Memanggil ini saat sedang mengambil aliran tidak berpengaruh. Setelah pratinjau berhenti, frame pratinjau membeku pada frame terakhir. */
mAlivcLivePusher.stopPreview();
/* Panggil untuk merestart pengambilan aliran saat aliran sedang diambil atau setelah menerima callback terkait error apa pun. Dalam status error, Anda hanya dapat memanggil API ini, reconnectPushAsync, atau destroy. Merestart akan menginisialisasi ulang semua resource internal AlivcLivePusher, termasuk pratinjau dan pengambilan aliran. */
mAlivcLivePusher.restartPush();
/* Panggil untuk menyambung ulang aliran saat sedang diambil atau setelah menerima callback error terkait AlivcLivePusherNetworkDelegate. Dalam status error, Anda hanya dapat memanggil API ini, restartPush, atau destroy. Menyambung ulang akan membangun kembali koneksi RTMP untuk pengambilan aliran. */
mAlivcLivePusher.reconnectPushAsync();
/* Panggil untuk menghapus instans pengambilan aliran. Setelah dihapus, pengambilan aliran dan pratinjau berhenti, serta surface pratinjau dihapus. Semua resource terkait AlivcLivePusher dilepaskan. */
mAlivcLivePusher.destroy();

/* Beralih antara kamera depan dan belakang. */
mAlivcLivePusher.switchCamera();
/* Mengaktifkan atau menonaktifkan flash. Mengaktifkan flash tidak berpengaruh saat kamera depan aktif. */
mAlivcLivePusher.setFlash(true); 
/* Menyesuaikan panjang fokus untuk memperbesar gambar yang diambil. Rentang zoom adalah [0, getMaxZoom()]. */
mAlivcLivePusher.setZoom(5);
/* Fokus manual kamera. Ini memerlukan dua parameter: 1. `point` (koordinat titik yang difokuskan) dan 2. `autoFocus` (apakah mengaktifkan autofokus untuk operasi ini). Perilaku autofokus berikutnya mengikuti nilai yang diatur oleh API setAutoFocus. */
mAlivcLivePusher.focusCameraAtAdjustedPoint(x, y, true);
/* Atur apakah akan mengaktifkan autofokus. */
mAlivcLivePusher.setAutoFocus(true);
/* Konfigurasi pencerminan. Terdapat dua API pencerminan: PushMirror untuk aliran yang diambil dan PreviewMirror untuk pratinjau lokal. PushMirror hanya memengaruhi tampilan pemutaran, sedangkan PreviewMirror hanya memengaruhi tampilan pratinjau. Keduanya tidak saling memengaruhi. */
mAlivcLivePusher.setPreviewMirror(false);
mAlivcLivePusher.setPushMirror(false);

Ambil aliran berbagi layar

Berbagi layar menggunakan MediaProjection dan memerlukan izin pengguna. Teruskan data hasil izin ke SDK. Kamera dinonaktifkan secara default selama berbagi layar.

// resultData adalah intent sistem berbagi layar.
mAlivcLivePushConfig.setMediaProjectionPermissionResultData(resultData);

mAlivcLivePusher.setScreenOrientation(0);

mAlivcLivePusher.pauseScreenCapture(); // Aktifkan perlindungan privasi.
mAlivcLivePusher.resumeScreenCapture(); // Nonaktifkan perlindungan privasi.

Ambil aliran kamera dan berbagi layar

Anda dapat mengaktifkan pengambilan kamera selama berbagi layar. Tersedia dua pendekatan:

1. Streamer memiliki pratinjau kamera.

   Baik streamer maupun pemirsa dapat melihat feed kamera.

2. Streamer tidak memiliki pratinjau kamera.

   Misalnya, selama streaming game, streamer mungkin tidak ingin tampilan kamera menghalangi permainan. Namun, pemirsa tetap dapat melihat feed kamera streamer dalam aliran akhir.

mAlivcLivePusher.startCamera(surfaceView); // Mulai pratinjau kamera.
mAlivcLivePusher.stopCamera(); // Hentikan pratinjau kamera.

mAlivcLivePusher.startCameraMix(x, y, w, h); // Aktifkan pencampuran aliran kamera dan atur tata letak x, y, w, dan h untuk aliran yang dicampur.
mAlivcLivePusher.stopCameraMix(); // Hentikan pencampuran aliran kamera.

Mode tampilan pratinjau

Tersedia tiga mode tampilan pratinjau. Mode tampilan tidak memengaruhi pengambilan aliran.

• ALIVC_LIVE_PUSHER_PREVIEW_SCALE_FILL: Video mengisi jendela pratinjau. Jika rasio aspek video dan jendela berbeda, pratinjau tampak terdistorsi.

• ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FIT: Rasio aspek video dipertahankan. Jika rasio aspek video dan jendela berbeda, bilah hitam muncul di pratinjau.

• ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FILL: Video dipotong agar sesuai dengan rasio aspek jendela. Jika rasio aspek berbeda, video dipotong.

Kode berikut memberikan contoh:

mAlivcLivePushConfig.setPreviewDisplayMode(AlivcPreviewDisplayMode.ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FIT);

Pengambilan aliran gambar

SDK dapat mengambil gambar placeholder saat aplikasi berada di latar belakang atau jaringan buruk.

Saat aplikasi masuk ke latar belakang, pengambilan video dijeda sementara audio tetap berlanjut. Tampilkan gambar placeholder untuk memberi tahu pemirsa:

mAlivcLivePushConfig.setPausePushImage("path/to/background.png"); // Atur gambar untuk pengambilan aliran latar belakang.

SDK mengambil gambar ini saat mendeteksi bitrate rendah, sehingga mengurangi tersendatnya video:

mAlivcLivePushConfig.setNetworkPoorPushImage("path/to/network_poor.png"); // Atur gambar yang diambil dalam kondisi jaringan buruk.

Pengambilan aliran hanya audio

mAlivcLivePushConfig.setAudioOnly(true);

Ambil aliran audio dan video eksternal

SDK mendukung pengambilan audio dan video dari sumber eksternal seperti file video.

Aktifkan input audio dan video kustom terlebih dahulu:

/**
* Parameter lain seperti resolusi output, laju sampel audio, dan jumlah channel diatur dalam objek konfigurasi
* menggunakan setResolution, setAudioSampleRate, dan setAudioChannels.
*/
mAlivcLivePushConfig.setExternMainStream(true,AlivcImageFormat.IMAGE_FORMAT_YUVNV12,AlivcSoundFormat.SOUND_FORMAT_S16);

Setelah mengaktifkan input audio dan video kustom, Anda dapat mengambil aliran eksternal.

/**
* API ini tidak mengontrol waktu. Pemanggil harus mengontrol waktu frame audio input.
*/
mAlivcLivePusher.inputStreamAudioData(byte[] data, int size, int sampleRate, int channels, long pts);

/**
* API ini tidak mengontrol waktu. Pemanggil harus mengontrol waktu frame video input.
*/
mAlivcLivePusher.inputStreamVideoData(byte[] data, int width, int height, int stride, int size, long pts, int rotation);

Konfigurasi watermark

Tambahkan satu atau beberapa watermark dalam format PNG:

mAlivcLivePushConfig.addWaterMark(waterPath,0.1,0.2,0.3); // Tambahkan watermark.

Konfigurasi kualitas video

Tiga mode kualitas video didukung: mode Prioritas Resolusi, mode Prioritas Kelancaran, dan mode Kustom.

mAlivcLivePushConfig.setQualityMode(AlivcQualityModeEnum.QM_RESOLUTION_FIRST); // Prioritaskan resolusi.

mAlivcLivePushConfig.setQualityMode(AlivcQualityModeEnum.QM_FLUENCY_FIRST); // Prioritaskan kelancaran.

mAlivcLivePushConfig.setQualityMode(AlivcQualityModeEnum.QM_CUSTOM); // Mode kustom
mAlivcLivePushConfig.setTargetVideoBitrate(1000); // Bitrate target: 1.000 kbit/s
mAlivcLivePushConfig.setMinVideoBitrate(300); // Bitrate minimum: 300 kbit/s
mAlivcLivePushConfig.setInitialVideoBitrate(800); // Bitrate awal: 800 kbit/s

Resolusi adaptif

Resolusi adaptif secara otomatis menurunkan resolusi dalam kondisi jaringan buruk untuk meningkatkan kelancaran:

mAlivcLivePushConfig.setEnableAutoResolution(true); // Aktifkan resolusi adaptif. Default-nya false.

Musik latar

SDK mendukung pemutaran musik latar, pencampuran, denoising, pemantauan in-ear, dan pembisuan:

/* Mulai memutar musik latar. */
mAlivcLivePusher.startBGMAsync(mPath)；
/* Hentikan pemutaran musik latar. Jika BGM sedang diputar dan Anda perlu mengganti lagu, cukup panggil API mulai musik latar lagi. Anda tidak perlu menghentikan BGM saat ini. */
mAlivcLivePusher.stopBGMAsync();
/* Jeda musik latar. Ini hanya dapat dipanggil setelah BGM mulai diputar. */
mAlivcLivePusher.pauseBGM();
/* Lanjutkan musik latar. Ini hanya dapat dipanggil saat BGM dijeda. */
mAlivcLivePusher.resumeBGM();
/* Aktifkan pengulangan untuk musik latar. */
mAlivcLivePusher.setBGMLoop(true);
/* Atur sakelar denoise. Saat diaktifkan, suara non-manusia dalam audio yang diambil akan disaring. Ini mungkin sedikit meredam suara manusia. Kami merekomendasikan agar pengguna memilih apakah akan mengaktifkan fitur ini. Fitur ini dinonaktifkan secara default. */
mAlivcLivePusher.setAudioDenoise(true);
/* Atur sakelar pemantauan in-ear. Fitur ini terutama digunakan dalam skenario karaoke. Saat diaktifkan dengan headphone terpasang, streamer akan mendengar suaranya sendiri. Saat dinonaktifkan, mereka tidak akan mendengarnya. Ini tidak berpengaruh jika headphone tidak terpasang. */
mAlivcLivePusher.setBGMEarsBack(true);
/* Konfigurasi pencampuran untuk menyesuaikan volume musik latar dan suara yang diambil. */
mAlivcLivePusher.setBGMVolume(50); // Atur volume musik latar.
mAlivcLivePusher.setCaptureVolume(50); // Atur volume suara yang diambil.
/* Bisukan audio. Ini membisukan musik dan input suara. Untuk membisukan hanya musik atau suara, gunakan API penyesuaian volume pencampuran. */
mAlivcLivePusher.setMute(true);

Tangkapan aliran

Ambil tangkapan aliran video lokal:

// Ambil tangkapan aliran video. Parameter: jumlah gambar yang diambil, interval antar pengambilan dalam detik, dan listener callback.
pusher.snapshot(1, 1, new AlivcSnapshotListener() {
    @Override
    public void onSnapshot(Bitmap bmp) {
        // Anda dapat menyimpan tangkapan ke file PNG lokal. Kode berikut adalah contoh.
        String dateFormat = new SimpleDateFormat("yyyy-MM-dd-hh-mm-ss-SS").format(new Date());
        File f = new File(context.getExternalFilesDir(Environment.DIRECTORY_PICTURES), "snapshot-" + dateFormat + ".png");
        if (f.exists()) {
            f.delete();
        }
        try {
            FileOutputStream out = new FileOutputStream(f);
            bmp.compress(Bitmap.CompressFormat.PNG, 90, out);
            out.flush();
            out.close();
        } catch (FileNotFoundException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
});

Berjalan di latar belakang dan kunci layar

• Saat aplikasi Anda dipindahkan ke latar belakang atau layar dikunci, Anda dapat memanggil metode pause() atau resume() dari AlivcLivePusher untuk menjeda atau melanjutkan pengambilan aliran.

• Untuk panggilan audio dan video non-sistem, SDK menangkap dan mengambil suara. Berdasarkan kebutuhan bisnis Anda, Anda dapat memanggil API mAlivcLivePusher.setMute(true or false) untuk menentukan apakah akan menangkap audio saat aplikasi berada di latar belakang atau layar dikunci.

Panggilan Balik

Metode dan API umum

/* Dalam mode Kustom, Anda dapat menyesuaikan bitrate minimum dan target secara real time. */
mAlivcLivePusher.setTargetVideoBitrate(800);
mAlivcLivePusher.setMinVideoBitrate(400);
/* Periksa apakah kamera mendukung autofokus. */
mAlivcLivePusher.isCameraSupportAutoFocus();
/* Periksa apakah kamera mendukung flash. */
mAlivcLivePusher.isCameraSupportFlash();
/* Dapatkan status pengambilan aliran saat ini. */
mAlivcLivePusher.isPushing(); 
/* Dapatkan URL ingest. */
mAlivcLivePusher.getPushUrl();
/* Dapatkan informasi performa dan debugging pengambilan aliran. Untuk detail parameter performa, lihat referensi API atau komentar antarmuka. */
mAlivcLivePusher.getLivePushStatsInfo();
/* Dapatkan nomor versi SDK. */
mAlivcLivePusher.getSDKVersion();
/* Atur tingkat log untuk memfilter informasi debugging sesuai kebutuhan. */
mAlivcLivePusher.setLogLevel(AlivcLivePushLogLevelAll);
/* Dapatkan status SDK saat ini. */
mAlivcLivePusher.getCurrentStatus();
/* Dapatkan kode error terakhir. Mengembalikan ALIVC_COMMON_RETURN_SUCCESS jika tidak ada error. */
mAlivcLivePusher.getLastError();

Integrasikan retouching

Impor library retouching dan konfigurasi callback untuk mengaktifkan retouching.

1. Impor library retouching melalui Maven. Tambahkan berikut ke file build.gradle Anda. Periksa Demo terbaru untuk versi SDK.

   implementation "com.aliyun.maliang.android:queen:2.5.0-official-full"
   implementation("com.aliyun.maliang.android:queen_menu:2.5.0-official-full") {
       exclude group: 'com.aliyun.maliang.android', module: 'queen'
   }

   Anda juga dapat mengintegrasikan modul LiveBeauty dari demo:

   File atau folder	Deskripsi
   live_beauty	Kelas abstrak dasar untuk retouching.
   queen_beauty	Kontrol UI dasar untuk retouching.

2. Dapatkan library plug-in retouching LiveBeauty.

   1. Gunakan perintah clone untuk mengunduh kode library plugin terkait dari path LiveBeauty ke mesin lokal Anda.

      git clone https://github.com/MediaBox-Demos/amdemos-android-live.git

   2. Buka command line di direktori root proyek Android Studio Anda. Jalankan kode berikut lalu gunakan File > New > Import Module  untuk mengimpor modul LiveBeauty ke proyek Android Anda.

      git submodule add https://github.com/MediaBox-Demos/amdemos-android-live.git ***/***/***

      Catatan

      Dalam kode contoh, /*** adalah placeholder untuk path ke modul LiveBeauty.

   3. Dalam file settings.gradle proyek, tambahkan path modul:

      include ':app', ':LiveBeauty', ':LiveBeauty:live_queenbeauty'

      Catatan

      Dalam kode contoh, "app" adalah modul utama.

   4. Juga, dalam file build.gradle modul utama proyek, tambahkan dependensi pada modul LiveBeauty:

      dependencies {
          implementation project(':LiveBeauty')
          implementation project(':LiveBeauty:live_queenbeauty')
      }

   5. Klik File > Sync Project with Gradle Files. Setelah sinkronisasi Gradle selesai, Anda dapat menggunakan modul LiveBeauty.

3. Konfigurasi modul UI plug-in retouching.

   1. Tambahkan kontrol QueenBeautyMenu ke file layout XML proyek Anda. Contoh:

      <com.aliyunsdk.queen.menu.QueenBeautyMenu
          android:id="@+id/beauty_beauty_menuPanel"
          android:layout_width="match_parent"
          android:layout_height="wrap_content"
          android:layout_alignParentBottom="true"
          android:layout_centerHorizontal="true" />

   2. Inisialisasi QueenBeautyMenu di Activity. Contoh:

      // Inisialisasi panel menu retouching.
      QueenMenuPanel beautyMenuPanel = QueenBeautyMenu.getPanel(context);
      beautyMenuPanel.onHideMenu(); 
      beautyMenuPanel.onHideValidFeatures(); 
      beautyMenuPanel.onHideCopyright(); 
      
      // Tambahkan menu retouching ke layout.
      QueenBeautyMenu beautyBeautyContainerView = findViewById(R.id.beauty_beauty_menuPanel);
      beautyBeautyContainerView.addView(beautyMenuPanel);

4. Atur callback pengenalan wajah dan retouching.

   Jika Anda perlu mengintegrasikan library retouching pihak ketiga, atur callback setCustomDetect dan setCustomFilter.

   • Dalam customDetectProcess, parameter data adalah pointer ke data yang diambil untuk pemrosesan pihak ketiga.

   • Dalam customFilterProcess, parameter inputTexture adalah tekstur gambar untuk diproses. Kembalikan ID tekstur yang telah diproses, atau inputTexture asli jika tidak dimodifikasi.

   Kode contoh

   /**
    * Callback pengenalan wajah.
    */
   mAlivcLivePusher.setCustomDetect(new AlivcLivePushCustomDetect() {
       @Override
       public void customDetectCreate() {
   
       }
   
       @Override
       public long customDetectProcess(long dataPtr, int width, int height, int rotation, int format, long extra) {
           return 0;
       }
   
       @Override
       public void customDetectDestroy() {
   
       }
   });
   
   /**
    * Callback retouching.
    */
    
   /**
    * Inisialisasi BeautyManager.
    */
   mAlivcLivePusher.setCustomFilter(new AlivcLivePushCustomFilter() {
       @Override
       public void customFilterCreate() {
           initBeautyManager();
       }
   
   /**
    * Proses aliran video yang diambil dan tambahkan efek retouching.
    */
       @Override
       public int customFilterProcess(int inputTexture, int textureWidth, int textureHeight, long extra) {
           if (mBeautyManager == null) {
               return inputTexture;
           }
   
           return mBeautyManager.onTextureInput(inputTexture, textureWidth, textureHeight);
       }
   
       @Override
       public void customFilterDestroy() {
           destroyBeautyManager();
       }
   });