ApsaraVideo Live：Penggunaan fitur

Daftarkan SDK

Untuk meminta dan mengonfigurasi lisensi, lihat Panduan Integrasi Lisensi.

Panggil metode pendaftaran lisensi pada tahap early, sebelum menggunakan Push SDK.

[AlivcLiveBase registerSDK];

• Kelas AlivcLiveBase memungkinkan Anda mengatur tingkat log, menetapkan path log lokal, dan mendapatkan versi SDK.

• Dalam metode onLicenceCheck dari antarmuka AlivcLiveBase#setObserver, periksa secara asinkron apakah lisensi telah dikonfigurasi.

Konfigurasikan parameter pengambilan aliran

Di ViewController tempat Anda memerlukan pusher, impor file header #import <AlivcLivePusher/AlivcLivePusher.h>.

Parameter pengambilan aliran dasar memiliki nilai default. Kami menyarankan Anda menggunakan nilai default tersebut. Anda dapat melakukan inisialisasi sederhana tanpa konfigurasi tambahan.

AlivcLivePushConfig *config = [[AlivcLivePushConfig alloc] init];// Inisialisasi kelas konfigurasi pengambilan aliran. Anda juga dapat menggunakan initWithResolution untuk inisialisasi.
config.resolution = AlivcLivePushResolution540P;// Resolusi default adalah 540P. Resolusi maksimum adalah 720P.
config.fps = AlivcLivePushFPS20; // Kami menyarankan Anda menggunakan 20 fps.
config.enableAutoBitrate = true; // Aktifkan kontrol bitrate. Nilai default adalah true.
config.videoEncodeGop = AlivcLivePushVideoEncodeGOP_2;// Nilai default adalah 2. Ukuran GOP yang lebih besar menghasilkan latensi lebih tinggi. Kami menyarankan Anda mengatur parameter ini ke 1 atau 2.
config.connectRetryInterval = 2000; // Satuan: milidetik. Durasi koneksi ulang adalah 2 detik. Interval koneksi ulang minimal 1 detik. Kami menyarankan Anda menggunakan nilai default.
config.previewMirror = false; // Nilai default adalah false. Dalam kondisi normal, pilih false.
config.orientation = AlivcLivePushOrientationPortrait; // Orientasi default adalah portrait. Anda dapat mengatur perangkat ke mode landscape dengan tombol home di kiri atau kanan.

Ambil aliran kamera

1. Inisialisasi.

   Setelah mengonfigurasi parameter pengambilan aliran, gunakan metode initWithConfig dari Push SDK untuk melakukan inisialisasi. Contoh kode:

   self.livePusher = [[AlivcLivePusher alloc] initWithConfig:config];

   Catatan

   AlivcLivePusher tidak mendukung beberapa instans. Oleh karena itu, setiap panggilan init harus diikuti oleh panggilan destroy yang sesuai.

2. Daftarkan callback pengambilan aliran.

   Callback pengambilan aliran berikut didukung:

   • Info: callback yang digunakan untuk notifikasi dan deteksi status.

   • Error: callback yang dikembalikan saat terjadi error.

   • Network: callback yang terkait dengan jaringan.

   Daftarkan delegate untuk menerima callback yang sesuai. Contoh kode:

   [self.livePusher setInfoDelegate:self];
   [self.livePusher setErrorDelegate:self];
   [self.livePusher setNetworkDelegate:self];

3. Mulai pratinjau.

   Setelah objek livePusher diinisialisasi, Anda dapat memulai pratinjau. Saat melakukan pratinjau, Anda harus memberikan tampilan untuk pratinjau kamera. Tampilan tersebut mewarisi dari UIView. Contoh kode:

   [self.livePusher startPreview:self.view];

4. Mulai pengambilan aliran.

   Anda hanya dapat memulai pengambilan aliran setelah pratinjau berhasil. Oleh karena itu, dengarkan callback onPreviewStarted dari AlivcLivePusherInfoDelegate dan tambahkan kode berikut di dalam callback tersebut.

   [self.livePusher startPushWithURL:@"URL pengambilan uji coba (rtmp://......)"];

   Catatan

   • URL pengambilan RTMP dan RTS (artc://) didukung. Untuk menghasilkan URL pengambilan, lihat Hasilkan URL streaming.

   • ApsaraVideo Live tidak mendukung pengambilan beberapa aliran ke URL pengambilan yang sama secara bersamaan. Permintaan pengambilan aliran kedua akan ditolak.

/* Beralih antara kamera depan dan belakang. */
[self.livePusher switchCamera];
/* Aktifkan atau nonaktifkan flash. Anda tidak dapat mengaktifkan flash untuk kamera depan. */
[self.livePusher setFlash:false]; 
/* Sesuaikan panjang fokus untuk memperbesar atau memperkecil frame yang ditangkap. Berikan angka positif untuk meningkatkan panjang fokus. Berikan angka negatif untuk mengurangi panjang fokus. */
CGFloat max = [_livePusher getMaxZoom];
[self.livePusher setZoom:MIN(1.0, max)]; 
/* Fokus manual. Untuk fokus manual, Anda harus memberikan dua parameter: 1. point: titik yang akan difokuskan (koordinat titik yang akan difokuskan). 2. autoFocus: menentukan apakah autofocus diaktifkan. Parameter ini hanya berlaku untuk operasi fokus panggilan API ini. Operasi autofocus berikutnya menggunakan nilai yang diatur oleh API autofocus. */
[self.livePusher focusCameraAtAdjustedPoint:CGPointMake(50, 50) autoFocus:true];
/* Atur apakah autofocus diaktifkan. */
[self.livePusher setAutoFocus:false];
/* Konfigurasikan pencerminan. Terdapat dua antarmuka pencerminan: PushMirror untuk pencerminan aliran pengambilan dan PreviewMirror untuk pencerminan pratinjau. Pengaturan PushMirror hanya berlaku pada layar pemutaran. Pengaturan PreviewMirror hanya berlaku pada layar pratinjau. Kedua pengaturan ini tidak saling memengaruhi. */
[self.livePusher setPushMirror:false];
[self.livePusher setPreviewMirror:false];

/* Anda dapat mengatur pauseImage lalu memanggil metode pause untuk beralih dari pengambilan aliran kamera ke pengambilan aliran gambar statis. Pengambilan aliran audio tetap berlanjut. */
[self.livePusher pause];
/* Beralih dari pengambilan aliran gambar statis ke pengambilan aliran kamera. Pengambilan aliran audio tetap berlanjut. */
[self.livePusher resume];
/* Dalam status streaming, Anda dapat memanggil metode ini untuk menghentikan pengambilan aliran. Setelah operasi selesai, pengambilan aliran berhenti. */
[self.livePusher stopPush];
/* Anda hanya dapat menghentikan pratinjau dalam status pratinjau. Jika Anda sedang mengambil aliran, menghentikan pratinjau tidak valid. Setelah pratinjau dihentikan, layar pratinjau membeku pada frame terakhir. */
[self.livePusher stopPreview];
/* Dalam status streaming atau saat menerima callback terkait Error apa pun, Anda dapat memanggil metode ini untuk memulai ulang pengambilan aliran. Dalam status error, Anda hanya dapat memanggil metode ini (atau reconnectPushAsync untuk koneksi ulang) atau memanggil destroy untuk menghapus instans pengambilan aliran. Setelah operasi selesai, pengambilan aliran dimulai ulang. Semua sumber daya internal ALivcLivePusher, termasuk pratinjau dan pengambilan aliran, dimulai ulang. */
[self.livePusher restartPush];
/* Dalam status streaming atau saat menerima callback Error terkait AlivcLivePusherNetworkDelegate, Anda dapat memanggil antarmuka ini. Dalam status error, Anda hanya dapat memanggil antarmuka ini (atau restartPush untuk memulai ulang pengambilan aliran) atau memanggil destroy untuk menghapus instans pengambilan aliran. Setelah operasi selesai, pengambilan aliran terhubung ulang. Koneksi RTMP untuk pengambilan aliran dibuat ulang. */
[self.livePusher reconnectPushAsync];
/* Setelah instans pengambilan aliran dihapus, pengambilan aliran dan pratinjau berhenti, serta layar pratinjau dihapus. Semua sumber daya terkait AlivcLivePusher dihapus. */
[self.livePusher destory];
self.livePusher = nil;
/* Dapatkan status pengambilan aliran. */
AlivcLivePushStatus status = [self.livePusher getLiveStatus];

Pengambilan aliran rekaman layar (berbagi layar)

ReplayKit adalah fitur yang diperkenalkan di iOS 9 yang mendukung perekaman layar. Di iOS 10, ReplayKit diperluas untuk memungkinkan pemanggilan ekstensi aplikasi pihak ketiga guna melakukan live streaming konten layar. Pada iOS 10 dan versi selanjutnya, Anda dapat menggunakan Push SDK bersama proses perekaman layar Ekstensi untuk mengimplementasikan berbagi layar dalam live streaming.

1. Buat App Group.

   Masuk ke Apple Developer dan lakukan operasi berikut:

   1. Di halaman Certificates, IDs & Profiles, daftarkan App Group. Untuk informasi selengkapnya, lihat Daftarkan App Group.

   2. Kembali ke halaman Identifier, pilih App IDs, lalu klik App ID Anda untuk mengaktifkan fitur App Group. App ID untuk proses aplikasi utama dan proses perekaman layar Ekstensi harus dikonfigurasi dengan cara yang sama. Untuk informasi selengkapnya, lihat Aktifkan App Group.

   3. Setelah operasi selesai, unduh kembali Provisioning Profile yang sesuai dan konfigurasikan di Xcode.

   Setelah Anda melakukan operasi dengan benar, proses perekaman layar Ekstensi dapat berkomunikasi dengan proses aplikasi utama.

   Catatan

   Setelah membuat App Group, simpan nilai App Group Identifier. Nilai ini diperlukan untuk langkah-langkah selanjutnya.

2. Buat proses perekaman layar Ekstensi.

   Demo iOS Push SDK menyediakan ekstensi aplikasi AlivcLiveBroadcast dan AlivcLiveBroadcastSetupUI yang mendukung berbagi layar untuk live streaming. Untuk membuat proses perekaman layar Ekstensi di aplikasi, lakukan langkah-langkah berikut:

   1. Di proyek yang sudah ada, pilih New > Target… dan pilih Broadcast Upload Extension, seperti yang ditunjukkan pada gambar berikut:

   2. Ubah Product Name, pilih Include UI Extension, lalu klik Finish untuk membuat ekstensi live streaming dan UI, seperti yang ditunjukkan pada gambar berikut:

   3. Konfigurasikan file Info.plist untuk ekstensi live streaming. Di target yang baru dibuat, Xcode secara default membuat file header dan file sumber bernama SampleHandler, seperti yang ditunjukkan pada gambar berikut:

      Seret AlivcLibReplayKitExt.framework ke proyek agar Target Ekstensi bergantung padanya.Ganti kode di SampleHandler.m dengan kode berikut. Ganti KAPP Group dalam kode dengan App Group Identifier yang Anda buat pada langkah pertama. Contoh kode:

      
      #import "SampleHandler.h"
      #import <AlivcLibReplayKitExt/AlivcLibReplayKitExt.h>
      
      @implementation SampleHandler
      
      - (void)broadcastStartedWithSetupInfo:(NSDictionary<NSString *,NSObject *>
      *)setupInfo {
      
       //User has requested to start the broadcast. Setup info from the UI extension can
      be supplied but optional.
       [[AlivcReplayKitExt sharedInstance] setAppGroup:kAPPGROUP];
      }
      
      - (void)processSampleBuffer:(CMSampleBufferRef)sampleBuffer withType:(RPSampleBufferType)sampleBufferType {
       if (sampleBufferType != RPSampleBufferTypeAudioMic) {
       // Audio is captured and sent by the main app process.
       [[AlivcReplayKitExt sharedInstance] sendSampleBuffer:sampleBuffer withType:sampleBufferType];
       }
      }
      
      - (void)broadcastFinished {
      
       [[AlivcReplayKitExt sharedInstance] finishBroadcast];
      }
      @end
      
                                          

   Di proyek Anda, buat target Broadcast Upload Extension. Di Target Ekstensi ini, integrasikan AlivcLibReplayKitExt.framework yang disesuaikan untuk modul ekstensi perekaman layar.

3. Integrasikan Live SDK ke proses aplikasi utama untuk pengambilan aliran berbagi layar.

   Di proses aplikasi utama untuk pengambilan aliran berbagi layar, buat objek AlivcLivePushConfig dan AlivcLivePusher. Atur ExternMainStream ke True dan AudioFromExternal ke False. Konfigurasi ini menunjukkan bahwa audio masih ditangkap oleh SDK. Panggil StartScreenCapture untuk mulai menerima data layar dari Aplikasi Ekstensi. Kemudian, mulai dan hentikan pengambilan aliran. Untuk informasi selengkapnya, lihat langkah-langkah berikut:

   1. Di proses aplikasi utama untuk pengambilan aliran berbagi layar, tambahkan dependensi pada AlivcLivePusher.framework, AlivcLibRtmp.framework, RtsSDK.framework, dan AlivcLibReplayKitExt.framework.

   2. Inisialisasi Push SDK dan konfigurasikan untuk menggunakan sumber video eksternal.

      Atur ExternMainStream ke True dan ExternVideoFormat ke AlivcLivePushVideoFormatYUV420P. Untuk menggunakan SDK internal untuk pengambilan audio, atur AudioFromExternal ke False. Konfigurasikan parameter pengambilan aliran lainnya. Untuk informasi selengkapnya, lihat contoh kode berikut:

       self.pushConfig.externMainStream = true;
       self.pushConfig.externVideoFormat = AlivcLivePushVideoFormatYUV420P;
       self.pushConfig.audioSampleRate = 44100;
       self.pushConfig.audioChannel = 2;
       self.pushConfig.audioFromExternal = false;
       self.pushConfig.videoEncoderMode = AlivcLivePushVideoEncoderModeSoft;
       self.pushConfig.qualityMode = AlivcLivePushQualityModeCustom;
       self.pushConfig.targetVideoBitrate = 2500;
       self.pushConfig.minVideoBitrate = 2000;
       self.pushConfig.initialVideoBitrate = 2000;
       self.livePusher = [[AlivcLivePusher alloc] initWithConfig:self.pushConfig];
      
                                      

   3. Gunakan AlivcLivePusher untuk melakukan fungsi terkait live streaming. Panggil fungsi-fungsi berikut:

      • Mulai menerima data layar.

        Ganti kAPPGroup dalam kode dengan App Group Identifier yang Anda buat. Contoh kode:

        [self.livePusher startScreenCapture:kAPPGROUP];

      • Mulai pengambilan aliran.

        Contoh kode:

        [self.livePusher startPushWithURL:self.pushUrl]

      • Hentikan pengambilan aliran.

        Contoh kode:

        [self.livePusher stopPush];
        [self.livePusher destory];
        self.livePusher = nil;

Mode tampilan pratinjau

Push SDK mendukung tiga mode pratinjau. Mode tampilan pratinjau tidak memengaruhi pengambilan aliran.

• ALIVC_LIVE_PUSHER_PREVIEW_SCALE_FILL: Pratinjau mengisi jendela. Jika rasio aspek video berbeda dari rasio aspek jendela, pratinjau akan terdistorsi.

• ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FIT: Rasio aspek video dipertahankan selama pratinjau. Jika rasio aspek video berbeda dari rasio aspek jendela, bar hitam akan muncul di pratinjau. Ini adalah mode default.

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

Contoh kode:

mAlivcLivePushConfig.setPreviewDisplayMode(AlivcPreviewDisplayMode.ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FIT);

Pengambilan aliran gambar

Untuk pengalaman pengguna yang lebih baik, SDK menyediakan pengaturan untuk pengambilan aliran gambar latar belakang dan pengambilan aliran gambar saat bitrate terlalu rendah. Saat SDK dipindahkan ke latar belakang, pengambilan aliran video dijeda secara default, dan hanya audio yang diambil. Pada saat ini, Anda dapat mengatur gambar untuk pengambilan aliran gambar. Misalnya, Anda dapat menampilkan gambar untuk mengingatkan pengguna bahwa streamer sedang pergi sebentar dan akan segera kembali. Contoh kode:

config.pauseImg = [UIImage imageNamed:@"image.png"];// Atur gambar untuk pengambilan aliran latar belakang.

Selain itu, saat jaringan buruk, Anda dapat mengatur gambar statis untuk diambil sesuai kebutuhan. Setelah Anda mengatur gambar tersebut, SDK akan mendeteksi saat bitrate saat ini rendah dan mengambil gambar ini untuk menghindari tersendatnya aliran video. Contoh kode:

config.networkPoorImg = [UIImage imageNamed:@"image.png"];// Atur gambar yang akan diambil saat jaringan buruk.

Dorong aliran audio dan video eksternal

Push SDK mendukung pengambilan sumber audio dan video eksternal, seperti file audio atau video.

1. Konfigurasikan input audio dan video eksternal dalam konfigurasi pengambilan aliran.

Contoh kode:

config.externMainStream = true;// Aktifkan input aliran eksternal.
config.externVideoFormat = AlivcLivePushVideoFormatYUVNV21;// Atur format warna data video. Dalam contoh ini, format diatur ke YUVNV21. Anda dapat mengatur format ke nilai lain sesuai kebutuhan.
config.externAudioFormat = AlivcLivePushAudioFormatS16;// Atur format kedalaman bit data audio. Dalam contoh ini, format diatur ke S16. Anda dapat mengatur format ke nilai lain sesuai kebutuhan.

2. Masukkan data video eksternal.

Contoh kode:

/* Hanya data buffer kontinu dalam format YUV dan RGB video eksternal yang dapat dikirim menggunakan antarmuka sendVideoData. Anda dapat mengirim buffer data video, panjang, lebar, tinggi, timestamp, dan sudut rotasi. */
[self.livePusher sendVideoData:yuvData width:720 height:1280 size:dataSize pts:nowTime rotation:0];
/* Jika data video eksternal dalam format CMSampleBufferRef, Anda dapat menggunakan antarmuka sendVideoSampleBuffer. */
[self.livePusher sendVideoSampleBuffer:sampleBuffer]
/* Anda juga dapat mengonversi format CMSampleBufferRef ke buffer kontinu lalu meneruskannya ke antarmuka sendVideoData. Berikut adalah kode referensi untuk konversi tersebut. */
// Dapatkan panjang buffer sampel.
- (int) getVideoSampleBufferSize:(CMSampleBufferRef)sampleBuffer {
if(!sampleBuffer) {
 return 0;
}
int size = 0;
CVPixelBufferRef pixelBuffer = CMSampleBufferGetImageBuffer(sampleBuffer);
CVPixelBufferLockBaseAddress(pixelBuffer, 0);
if(CVPixelBufferIsPlanar(pixelBuffer)) {
 int count = (int)CVPixelBufferGetPlaneCount(pixelBuffer);
 for(int i=0; i<count; i++) {
 int height = (int)CVPixelBufferGetHeightOfPlane(pixelBuffer,i);
 int stride = (int)CVPixelBufferGetBytesPerRowOfPlane(pixelBuffer,i);
 size += stride*height;
 }
}else {
 int height = (int)CVPixelBufferGetHeight(pixelBuffer);
 int stride = (int)CVPixelBufferGetBytesPerRow(pixelBuffer);
 size += stride*height;
}
CVPixelBufferUnlockBaseAddress(pixelBuffer, 0);
return size;
}
// Konversi buffer sampel ke buffer kontinu.
- (int) convertVideoSampleBuffer:(CMSampleBufferRef)sampleBuffer toNativeBuffer:(void*)nativeBuffer
{
if(!sampleBuffer || !nativeBuffer) {
 return -1;
}
CVPixelBufferRef pixelBuffer = CMSampleBufferGetImageBuffer(sampleBuffer);
CVPixelBufferLockBaseAddress(pixelBuffer, 0);
int size = 0;
if(CVPixelBufferIsPlanar(pixelBuffer)) {
 int count = (int)CVPixelBufferGetPlaneCount(pixelBuffer);
 for(int i=0; i<count; i++) {
 int height = (int)CVPixelBufferGetHeightOfPlane(pixelBuffer,i);
 int stride = (int)CVPixelBufferGetBytesPerRowOfPlane(pixelBuffer,i);
 void *buffer = CVPixelBufferGetBaseAddressOfPlane(pixelBuffer, i);
 int8_t *dstPos = (int8_t*)nativeBuffer + size;
 memcpy(dstPos, buffer, stride*height);
 size += stride*height;
 }
}else {
 int height = (int)CVPixelBufferGetHeight(pixelBuffer);
 int stride = (int)CVPixelBufferGetBytesPerRow(pixelBuffer);
 void *buffer = CVPixelBufferGetBaseAddress(pixelBuffer);
 size += stride*height;
 memcpy(nativeBuffer, buffer, size);
}
CVPixelBufferUnlockBaseAddress(pixelBuffer, 0);
return 0;
}

3. Masukkan data audio.

Contoh kode:

/* Hanya data buffer kontinu dalam format PCM eksternal yang didukung. Gunakan sendPCMData untuk mengirim buffer data audio, panjang, dan timestamp. */
[self.livePusher sendPCMData:pcmData size:size pts:nowTime];

Konfigurasikan watermark

Push SDK menyediakan fitur untuk menambahkan watermark. Anda dapat menambahkan beberapa watermark. Gambar watermark harus dalam format PNG. Contoh kode:

NSString *watermarkBundlePath = [[NSBundle mainBundle] pathForResource:
[NSString stringWithFormat:@"watermark"] ofType:@"png"];// Atur path gambar watermark.
[config addWatermarkWithPath: watermarkBundlePath
 watermarkCoordX:0.1
 watermarkCoordY:0.1
 watermarkWidth:0.3];// Tambahkan watermark.

Atur kualitas video

Kualitas video mendukung tiga mode: prioritas resolusi, prioritas kelancaran, dan kustom.

config.qualityMode = AlivcLivePushQualityModeResolutionFirst；// Mode prioritas resolusi

config.qualityMode = AlivcLivePushQualityModeFluencyFirst；// Mode prioritas kelancaran

config.qualityMode = AlivcLivePushQualityModeCustom// Atur ke mode kustom.
config.targetVideoBitrate = 1400; // Bitrate target adalah 1.400 kbit/s.
config.minVideoBitrate = 600; // Bitrate minimum adalah 600 kbit/s.
config.initialVideoBitrate = 1000; // Bitrate awal adalah 1.000 kbit/s.

Saat Anda mengatur bitrate kustom, rujuk pengaturan yang direkomendasikan oleh Alibaba Cloud untuk mengonfigurasi bitrate yang sesuai. Untuk informasi selengkapnya tentang pengaturan yang direkomendasikan, lihat tabel berikut:

Resolusi adaptif

Saat penyesuaian resolusi dinamis diaktifkan, resolusi aliran pengambilan secara otomatis menurun dalam kondisi jaringan buruk. Hal ini meningkatkan kelancaran dan kejelasan video. Contoh kode:

config.enableAutoResolution = YES; // Aktifkan resolusi adaptif. Nilai default adalah NO.

Musik latar

Push SDK mendukung pemutaran musik latar, pencampuran audio, penghilangan derau, pemantauan in-ear, dan pembisuan. Panggil operasi API terkait hanya setelah pratinjau dimulai. Kode berikut memberikan contoh:

/* Mulai memutar musik latar. */
[self.livePusher startBGMWithMusicPathAsync:musicPath];
/* Hentikan pemutaran musik latar. Jika Anda ingin mengganti lagu saat musik latar sedang diputar, cukup panggil operasi startBGMWithMusicPathAsync. Anda tidak perlu menghentikan pemutaran saat ini. */
[self.livePusher stopBGMAsync];
/* Jeda musik latar. Panggil operasi ini hanya setelah musik latar mulai diputar. */
[self.livePusher pauseBGM];
/* Lanjutkan musik latar. Panggil operasi ini hanya saat musik latar dijeda. */
[self.livePusher resumeBGM];
/* Aktifkan putar ulang berulang. */
[self.livePusher setBGMLoop:true];
/* Atur sakelar penghilangan derau. Saat diaktifkan, suara non-vokal dalam audio yang ditangkap akan difilter. Hal ini mungkin menyebabkan sedikit penekanan pada suara manusia. Biarkan pengguna memutuskan apakah akan mengaktifkan fitur ini. Fitur ini dinonaktifkan secara default. */
[self.livePusher setAudioDenoise:true];
/* Atur sakelar pemantauan in-ear. Fitur ini terutama digunakan dalam skenario karaoke. Saat diaktifkan, streamer dapat mendengar suaranya sendiri di headphone. Saat dinonaktifkan, streamer tidak dapat mendengar suaranya sendiri. Fitur ini tidak berfungsi jika headphone tidak terhubung. */
[self.livePusher setBGMEarsBack:true];
/* Konfigurasikan pencampuran audio untuk menyesuaikan volume musik latar dan suara manusia yang ditangkap. */
[self.livePusher setBGMVolume:50];// Atur volume musik latar.
[self.livePusher setCaptureVolume:50];// Atur volume suara manusia yang ditangkap.
/* Bisukan audio. Saat dibisukan, baik musik latar maupun suara manusia yang ditangkap akan dibisukan. Untuk membisukan musik atau suara secara terpisah, gunakan operasi pencampuran audio untuk menyesuaikan volumenya. */
[self.livePusher setMute:isMute?true:false];

Ambil tangkapan

Push SDK memungkinkan Anda mengambil tangkapan aliran video lokal. Berikut adalah contoh kode:

/* Atur callback tangkapan. */
[self.livePushersetSnapshotDelegate:self];
/* Panggil API tangkapan. */
[self.livePushersnapshot:1interval:1];

Konfigurasikan fitur kuis live

Fitur kuis live bekerja dengan menyisipkan informasi peningkatan suplemen (SEI) ke dalam aliran live. Pemutar kemudian mengurai SEI tersebut. Push SDK menyediakan metode untuk menyisipkan pesan SEI. Panggil metode ini hanya selama pengambilan aliran. Kode berikut adalah contoh:

/*
msg: Isi pesan SEI yang akan disisipkan ke aliran. Format JSON direkomendasikan. SDK Pemutar Video Apsara dapat menerima dan mengurai pesan ini untuk ditampilkan.
repeatCount: Jumlah frame tempat pesan dikirim. Untuk mencegah pesan SEI dijatuhkan, atur jumlah pengulangan. Misalnya, nilai 100 menyisipkan pesan ke 100 frame berikutnya. Pemutar menghapus duplikat pesan SEI yang identik.
delayTime: Penundaan dalam milidetik sebelum mengirim pesan.
KeyFrameOnly: Menentukan apakah pesan hanya dikirim dalam keyframe.
*/
[self.livePusher sendMessage:@"Informasi pertanyaan" repeatCount:100 delayTime:0 KeyFrameOnly:false];

Adaptasi iPhone X

Secara normal, mengatur tampilan pratinjau ke layar penuh berfungsi dengan benar. Namun, iPhone X memiliki rasio aspek khusus. Hal ini menyebabkan gambar pratinjau meregang saat ditampilkan dalam layar penuh. Jangan gunakan tampilan layar penuh untuk pratinjau di iPhone X.

Ubah ukuran tampilan selama pengambilan aliran

Lalui UIView yang ditetapkan dalam panggilan startPreview atau startPreviewAsync. Ubah frame untuk semua subview dalam tampilan pratinjau. Misalnya:

[self.livePusher startPreviewAsync:self.previewView];
for (UIView *subView in [self.previewView subviews]) {
 // ...
}

Mainkan audio eksternal

Untuk memutar audio eksternal di halaman pengambilan aliran, gunakan AVAudioPlayer karena kit pengembangan perangkat lunak (SDK) sementara tidak kompatibel dengan AudioServicesPlaySystemSound. Setelah pemutaran, perbarui pengaturan AVAudioSession. Berikut adalah contoh kode:

- (void)setupAudioPlayer {
 NSString *filePath = [[NSBundle
mainBundle] pathForResource:@"sound" ofType:@"wav"];
 NSURL *fileUrl = [NSURL URLWithString:filePath];
 self.player = [[AVAudioPlayer alloc] initWithContentsOfURL:fileUrl error:nil];
 self.player.volume = 1.0;
 [self.player prepareToPlay];
}
 - (void)playAudio {
 self.player.volume = 1.0;
 [self.player play];
 // Konfigurasikan AVAudioSession.
 AVAudioSession *session = [AVAudioSession sharedInstance];
 [session setMode:AVAudioSessionModeVideoChat error:nil];
 [session overrideOutputAudioPort:AVAudioSessionPortOverrideSpeaker error:nil];
 [session setCategory:AVAudioSessionCategoryPlayAndRecord withOptions:AVAudioSessionCategoryOptionDefaultToSpeaker|AVAudioSessionCategoryOptionAllowBluetooth
| AVAudioSessionCategoryOptionMixWithOthers error:nil];
 [session setActive:YES error:nil];
}

Mode latar belakang dan panggilan telepon

SDK menangani pemrosesan latar belakang secara otomatis. Secara default, saat aplikasi berpindah ke latar belakang, SDK terus mengambil aliran audio dan menjeda video pada frame terakhir. Untuk memastikan aplikasi dapat mengumpulkan audio di latar belakang, buka Capabilities aplikasi Anda, aktifkan Background Mode, dan pilih Audio, AirPlay and Picture in Picture.

Untuk menghentikan pengambilan aliran audio saat aplikasi berpindah ke latar belakang, hapus mesin pengambilan aliran. Saat aplikasi kembali ke latar depan, buat ulang mesin untuk melanjutkan aliran.

Panggilan Balik

Push SDK mencakup callback berikut:

Metode dan antarmuka umum

/* Dalam mode kustom, Anda dapat menyesuaikan bitrate minimum dan target secara real-time. */
[self.livePusher setTargetVideoBitrate:800];
[self.livePusher setMinVideoBitrate:200]
/* Dapatkan status pengambilan aliran. */
BOOL isPushing = [self.livePusher isPushing]; 
/* Dapatkan URL pengambilan. */
NSString *pushURLString = [self.livePusher getPushURL];
/* Dapatkan informasi performa dan debugging pengambilan aliran. Untuk detail metrik performa, lihat dokumentasi API atau komentar dalam kode. */
AlivcLivePushStatsInfo *info = [self.livePusher getLivePushStatusInfo];
/* Dapatkan nomor versi SDK. */
NSString *sdkVersion = [self.livePusher getSDKVersion];
/* Atur tingkat log untuk memfilter informasi debugging sesuai kebutuhan. */
[self.livePusher setLogLevel:(AlivcLivePushLogLevelDebug)];

Alat debugging

SDK menyediakan alat debugging UI DebugView, jendela mengambang global yang dapat dipindahkan dan selalu ditampilkan di atas tampilan. Alat ini mencakup fitur debugging seperti melihat log pengambilan aliran, deteksi real-time metrik performa pengambilan aliran, dan grafik garis metrik performa utama.

Contoh kode:

[AlivcLivePusher showDebugView];// Buka DebugView.