Menggunakan Trek Media

Jalur media dapat berupa objek streaming audio atau video, atau objek teks (subtitel atau teks).

Objek GCKMediaTrack mewakili trek. Terdiri dari ID numerik unik dan atribut lainnya seperti ID dan judul konten. Instance GCKMediaTrack dapat dibuat sebagai berikut:

Swift
let captionsTrack = GCKMediaTrack.init(identifier: 1,
                                       contentIdentifier: "https://some-url/caption_en.vtt",
                                       contentType: "text/vtt",
                                       type: GCKMediaTrackType.text,
                                       textSubtype: GCKMediaTextTrackSubtype.captions,
                                       name: "English Captions",
                                       languageCode: "en",
                                       customData: nil)
Objective-C
GCKMediaTrack *captionsTrack =
      [[GCKMediaTrack alloc] initWithIdentifier:1
                              contentIdentifier:@"https://some-url/caption_en.vtt"
                                    contentType:@"text/vtt"
                                           type:GCKMediaTrackTypeText
                                    textSubtype:GCKMediaTextTrackSubtypeCaptions
                                           name:@"English Captions"
                                   languageCode:@"en"
                                     customData:nil];

Item media dapat memiliki beberapa trek; misalnya, dapat memiliki beberapa subtitel (masing-masing untuk bahasa yang berbeda) atau beberapa aliran audio alternatif (untuk bahasa yang berbeda). GCKMediaInformation adalah class yang merepresentasikan item media. Untuk mengaitkan kumpulan objek GCKMediaTrack dengan item media, aplikasi Anda harus memperbarui properti mediaTracks-nya. Aplikasi Anda harus membuat asosiasi ini sebelum memuat media ke penerima, seperti dalam kode berikut:

Swift
let tracks = [captionsTrack]

let url = URL.init(string: "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4")
guard let mediaURL = url else {
  print("invalid mediaURL")
  return
}

let mediaInfoBuilder = GCKMediaInformationBuilder.init(contentURL: mediaURL)
mediaInfoBuilder.streamType = GCKMediaStreamType.none;
mediaInfoBuilder.contentType = "video/mp4"
mediaInfoBuilder.metadata = metadata;
mediaInfoBuilder.mediaTracks = tracks;
mediaInformation = mediaInfoBuilder.build()
Objective-C
NSArray *tracks = @[captionsTrack];

GCKMediaInformationBuilder *mediaInfoBuilder =
  [[GCKMediaInformationBuilder alloc] initWithContentURL:
   [NSURL URLWithString:@"https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"]];
mediaInfoBuilder.streamType = GCKMediaStreamTypeNone;
mediaInfoBuilder.contentType = @"video/mp4";
mediaInfoBuilder.metadata = metadata;
mediaInfoBuilder.mediaTracks = tracks;
self.mediaInformation = [mediaInfoBuilder build];

Aktifkan satu atau beberapa trek yang terkait dengan item media (setelah media dimuat) dengan memanggil -[setActiveTrackIDs:] di GCKRemoteMediaClient dan meneruskan ID trek yang akan diaktifkan. Misalnya, kode berikut mengaktifkan trek teks yang dibuat di atas.

Swift
sessionManager.currentSession?.remoteMediaClient?.setActiveTrackIDs([1])
Objective-C
[self.sessionManager.currentSession.remoteMediaClient setActiveTrackIDs:@[@1]];

Untuk menonaktifkan trek pada item media saat ini, panggil -[setActiveTrackIDs:] di GCKRemoteMediaClient dengan array kosong atau nol. Kode berikut menonaktifkan trek teks.

Swift
sessionManager.currentSession?.remoteMediaClient?.setActiveTrackIDs([])
Objective-C
[self.sessionManager.currentSession.remoteMediaClient setActiveTrackIDs:@[]];

Memberi gaya pada trek teks

Class GCKMediaTextTrackStyle merangkum informasi gaya trek teks. Gaya trek dapat diterapkan ke item media yang sedang diputar dengan memanggil -[GCKRemoteMediaClient setTextTrackStyle]. Gaya trek yang dibuat dalam kode di bawah mengubah teks menjadi merah (FF) dengan opasitas 50% (80) dan menetapkan font serif.

Swift
let textTrackStyle = GCKMediaTextTrackStyle.createDefault()
textTrackStyle.foregroundColor = GCKColor.init(cssString: "#FF000080")
textTrackStyle.fontFamily = "serif"
styleChangeRequest = sessionManager.currentSession?.remoteMediaClient?.setTextTrackStyle(textTrackStyle)
styleChangeRequest?.delegate = self
Objective-C
GCKMediaTextTrackStyle *textTrackStyle = [GCKMediaTextTrackStyle createDefault];
[textTrackStyle setForegroundColor:[[GCKColor alloc] initWithCSSString:@"#FF000080"]];
[textTrackStyle setFontFamily:@"serif"];
self.styleChangeRequest = [self.sessionManager.currentSession.remoteMediaClient setTextTrackStyle:textTrackStyle];
self.styleChangeRequest.delegate = self;

Anda dapat menggunakan objek GCKRequest yang ditampilkan untuk melacak permintaan ini.

Swift
// MARK: - GCKRequestDelegate

func requestDidComplete(_ request: GCKRequest) {
  if request == styleChangeRequest {
    print("Style update completed.")
    styleChangeRequest = nil
  }
}
Objective-C
#pragma mark - GCKRequestDelegate

- (void)requestDidComplete:(GCKRequest *)request {
  if (request == self.styleChangeRequest) {
    NSLog(@"Style update completed.");
    self.styleChangeRequest = nil;
  }
}

Lihat Pembaruan status di bawah untuk mengetahui informasi selengkapnya. Aplikasi harus mengizinkan pengguna memperbarui gaya untuk trek teks, baik menggunakan setelan yang disediakan oleh sistem maupun oleh aplikasi itu sendiri. Ada gaya default yang disediakan, yang dapat diambil melalui metode statis +[GCKMediaTextTrackStyle createDefault]. Elemen gaya trek teks berikut dapat diubah:

  • Warna dan opasitas latar depan (teks)
  • Warna dan opasitas latar belakang
  • Jenis tepi
  • Warna Tepi
  • Skala Font
  • Jenis Font
  • Gaya Font

Menerima info terbaru status

Jika beberapa pengirim terhubung ke penerima yang sama, setiap pengirim harus mengetahui perubahan pada penerima meskipun perubahan tersebut dimulai dari pengirim lain.

Untuk memastikan pengirim Anda menerima pembaruan status dari penerima, aplikasi Anda harus mendaftarkan GCKRemoteMediaClientListener. Jika GCKMediaTextTrackStyle media saat ini berubah, semua pengirim yang terhubung akan diberi tahu melalui callback -[remoteMediaClient:didUpdateMediaMetadata:] dan -[remoteMediaClient:didUpdateMediaStatus:]. Dalam hal ini, Receiver SDK tidak memverifikasi apakah gaya baru berbeda dari gaya sebelumnya dan memberi tahu semua pengirim yang terhubung. Namun, jika daftar trek aktif diperbarui, hanya -[remoteMediaClient:didUpdateMediaStatus:] di pengirim yang terhubung yang akan diberi tahu.

Memenuhi persyaratan CORS

Untuk streaming media adaptif, Google Cast memerlukan kehadiran header CORS, tetapi bahkan streaming media mp4 sederhana memerlukan CORS jika menyertakan Track. Jika Anda ingin mengaktifkan Jalur untuk media apa pun, Anda harus mengaktifkan CORS untuk aliran jalur dan aliran media. Jadi, jika Anda tidak memiliki header CORS yang tersedia untuk media mp4 sederhana di server, lalu menambahkan trek subtitle sederhana, Anda tidak akan dapat melakukan streaming media kecuali jika Anda memperbarui server untuk menyertakan header CORS yang sesuai. Selain itu, Anda harus mengizinkan setidaknya header berikut: Content-Type, Accept-Encoding, dan Range. Perhatikan bahwa dua header terakhir adalah header tambahan yang mungkin tidak Anda perlukan sebelumnya.

Sebelumnya
Sesuaikan UI
Berikutnya
Mengantre