Integrasi Apple FairPlay

Register FairPlay sebelum integrasi #

Atur penyebaran FairPlay dan material sertifikat dalam DRM-X Konsol. Material kunci privat tetap dienkripsi dan sisi server-. Publiskan sebuah HLS / CBCS varian untuk Content ID Anda berencana untuk menguji.

Meminta sesi Apple #

Kirim drmSystem: fairplay, manifestTypes: ["hls"], dan nilai clientPlatform yang sesuai melalui backend terautentikasi Anda. Respons berisi manifest HLS terdaftar, endpoint sertifikat, endpoint lisensi CKC, petunjuk otorisasi, dan endpoint untuk melepaskan sesi.

AVFoundation urutan #

1. Muat sertifikat.Ambil dari FairPlay sertifikat URL yang dikembalikan dengan otorisasi berumur pendek yang dikembalikan.
2. Buat data content-key. Gunakan skd:// identifier yang disediakan oleh playlist HLS dan sertifikat aplikasi.
3. Kirim SPC.POST tepat SPC byte ke lisensi yang dikembalikan URL dan menerima persis CKC byte.
4. Selesai dan lepaskan. Jawab permintaan konting-kunci, kemudian lepaskan DRM-X sesi ketika melihat berakhir.

Safari dan penerimaan aplikasi #

• Coba iPhone dan iPad Safari dengan asli HLS FairPlay.
• Uji macOS Safari dengan kualifikasi Shaka MSE FairPlay dimana tersedia dan asli HLS fallback.
• Uji awal iOS, iPadOS, dan tvOS putar, Kebijakan AirPlay, AV kebijakan adaptor, transisi latar belakang, perubahan pembaharuan, dan keluaran.
• Gunakan Development dan Produksi yang berbeda FairPlay pengosongan dan kredensial.

Satu paket, tiga pilihan integrasi #

Gunakan Universal Player untuk iOS / iPadOS, Universal Player untuk tvOS, atau integrasi AVPlayer asli di atas. Semua gunakan DrumX yang sama paket FairPlay dan titik akhir sesi pelanggan. Aplikasi host menyediakan otentikasi pelanggan; penyewa kredensial tetap pada backend.

Streaming pemutar menyediakan playlist, shuffle / repeat, membatalkan auto-next, posisi melanjutkan, mencari, kecepatan, preferensi kualitas, pemilihan audio / subtitle, ukuran judul, penanda, bab opsional / transkrip, A-B loops, timers tidur, dan layar penuh. Tata letak beradaptasi untuk menyentuh layar dan remote Apple TV.

let playlist = try DrmXPlaylist(items: [
    DrmXPlaylistItem(contentId: "lesson-1", title: "Getting started"),
    DrmXPlaylistItem(contentId: "lesson-2", title: "Next lesson")
])
let model = DrmXUniversalPlayer(
    endpoint: URL(string: "https://customer.example/api/drmx/playback-session")!,
    playlist: playlist,
    storageNamespace: "your-tenant-and-viewer"
) {
    ["Authorization": "Bearer \(customerAccessToken)"]
}
// Retain the model with @StateObject or an owning coordinator.
DrmXUniversalPlayerView(model: model)
// Stop when the owning screen is actually dismissed.
model.stop()

Pengaturan kualitas adalah preferensi maksimum dalam langit-langit sesi yang dikembalikan. AVPlayer beradaptasi ke lebar bandwidth yang tersedia; FairPlay lisensi dan pembatasan keluaran tetap otoritatif. Posisi dan bookmarks tetap bertahan oleh namespace pelanggan / viewer tanpa menyimpan pemutaran kredensial.

Sumber pengembangan saat ini tempat Sebelumnya / Play- Pause / Next, CC, Pengaturan dan layar penuh di dalam video. Kontrol bersembunyi setelah dua detik selama putar dan muncul kembali pada interaksi sentuh atau remote. Shuffle, ulangi dan VOD kemajuan bertahan dalam namespace pelanggan / viewer yang diberikan, termasuk pemutaran yang diunduh. Dengan mengocok dan mengulang, antrian berhenti setelah video akhir.

Unduhan terproteksi di iPhone dan iPad

Pass yang terotentikasi offlineEndpoint ke DrmXUniversalPlayer untuk mengaktifkan mode Unduh dan downhawded- video. The iOS implementasi menggunakan AVAssetDownloadURLSession untuk lokal HLS paket dan AVContentKeySession Untuk menyimpang-terikat gigih FairPlay Ini menyimpan kunci asli dan metadata lokal, tidak pernah DRM License Tokens atau kunci kosong. Download terisolasi oleh namespace pelanggan / viewer. Antrian luring berisi item katalog yang telah selesai dan berbagi posisi yang disimpan, shuffle dan repeat. Pembaruan Lisensi memerlukan otorisasi online segar; hapus penghapusan hanya unduhan yang dipilih.

The PHP dukungan sampel fairplay/hls/ios persisten permintaan. Konfigurasikan setiap butir isi terpercaya hlsManifestUrl; rute sertifikat menggunakan penyebaran aktif dalam token yang baru diterbitkan. FairPlay memaksa habis. Kualitas offline tetap kualitas yang diunduh, dan hanya jalur bahasa cache yang dapat dipilih. tvOS gunakan streaming pemutar.

Kualifikasi penangkapan layar

Gunakan iPad dan Apple TV simulator untuk tata letak, kontrol playlist, pengaturan, dan navigasi jarak jauh. FairPlay pemutaran tidak tersedia dalam simulator ini; SDK melaporkan pembatasan ini dan melepaskan reservasi nya daripada membuat sesi kunci yang tidak didukung. Hasil dari Simulator UI tidak membangun dukungan terproteksi, pemutaran offline, atau penerimaan perangkat fisik.

Pemutar menjeda audio/video saat iOS melaporkan perekaman atau pencerminan aktif dan menutupi adegan yang tidak aktif. Notifikasi tangkapan layar datang setelah pengambilan dan tidak dapat mengubah gambar yang sudah disimpan.