Framework CAS

Framework sistem akses bersyarat Media (Media CAS) menyediakan API standar untuk mengaktifkan layanan akses bersyarat (CA) di berbagai hardware TV digital, termasuk sistem kabel digital, satelit, terestrial, dan IPTV. Framework ini berfungsi dengan framework Input TV Android dan framework Tuner TV Android, yang menyediakan Java API yang dipanggil dari aplikasi Layanan Input TV (TIS).

Tujuan utama Media CAS adalah sebagai berikut.

  • Menyediakan API Java publik dan framework plugin native yang dapat digunakan oleh developer pihak ketiga dan OEM untuk mendukung CAS bagi TV siaran di Android.
  • Menyediakan framework CAS dalam Android yang memungkinkan OEM ATV beroperasi dengan berbagai vendor CAS secara konsisten.
  • Mendukung beberapa vendor CAS pihak ketiga menggunakan plugin native. Plugin CAS dapat menggunakan protokol jaringan khusus vendor, format pesan pengelolaan hak (EMM)/pesan kontrol hak (ECM), dan pengacak.
  • Mendukung keamanan hardware seperti tangga kunci.
  • Mendukung trusted execution environment (TEE) seperti TrustZone.

Konfigurasi yang didukung

Konfigurasi Tuner Hardware

Jika hardware bertanggung jawab untuk demultipleksing dan penguraian MPEG transport stream, framework Tuner menyediakan data informasi khusus program (PSI) akses bersyarat ke aplikasi TIS untuk berinteraksi dengan tuner TV berbasis hardware.

Data PSI akses bersyarat mencakup deskriptor CA, ECM, dan EMM. Struktur ini memungkinkan plugin CAS mendapatkan kunci yang diperlukan untuk mendekripsi streaming konten.

Diagram konfigurasi Tuner hardware.

Gambar 1. Konfigurasi Tuner Hardware

Konfigurasi hardware mungkin memiliki lapisan TEE, seperti TrustZone, yang diilustrasikan pada Gambar 1. Jika tidak ada lapisan TEE, plugin klien CAS dapat berkomunikasi dengan layanan tangga kunci hardware yang disediakan oleh platform. Karena variasi khusus vendor pada antarmuka ini, Media CAS tidak menstandarkannya.

Konfigurasi software

Sebelum Android 11, framework Media CAS masih dapat digunakan untuk memproses konten berbasis software, seperti IPTV dari multicast/unicast IP. Aplikasi TIS bertanggung jawab untuk membuat instance dan menyediakan objek Java Media CAS dengan benar.

Aplikasi dapat menggunakan MediaExtractor atau parser MPEG2-TS lainnya untuk mengekstrak data PSI terkait CA, seperti deskriptor CA, ECM, dan EMM. Jika aplikasi menggunakan framework MediaExtractor, aplikasi dapat mendelegasikan pengelolaan sesi CAS, seperti membuka sesi dan memproses EMM/ECM, ke framework MediaExtractor. Kemudian, MediaExtractor mengonfigurasi sesi CAS menggunakan API asli secara langsung.

Jika tidak, aplikasi bertanggung jawab untuk mengekstrak data PSI terkait CA dan mengonfigurasi sesi CAS menggunakan Media CAS Java API (misalnya, saat aplikasi menggunakan parser MPEG2-TS-nya sendiri).

Diagram konfigurasi Tuner.

Gambar 2. Konfigurasi input IPTV, CAS, dan pengacak menggunakan framework MediaExtractor

Dalam skenario ekstraktor software, ekstraktor memerlukan objek pengacak balik berbasis software atau hardware untuk setiap trek yang diacak, terlepas dari apakah trek tersebut memerlukan dekoder yang aman atau tidak. Hal ini disebabkan oleh hal berikut.

  • Jika trek tidak memerlukan dekode aman, ekstraktor akan mengacak unit akses untuk menghapus buffer dan mengekstrak sampel seolah-olah dari streaming yang jelas. Dengan cara ini, MediaCodec tidak perlu terlibat dalam penguraian.

  • Jika jalur memerlukan dekode aman, ekstraktor mungkin masih memerlukan pengacak. Hal ini terjadi saat aliran transport diacak di tingkat paket transport, dengan header aliran elemen yang dipaketkan (PES) diacak. Ekstraktor perlu mengakses header PES untuk meneruskan informasi tertentu (misalnya, stempel waktu presentasi).

    Pengacak tidak digunakan oleh ekstraktor jika aliran transport diacak di tingkat paket PES, dengan header PES dibiarkan jelas. Namun, tidak mungkin mengonfirmasi kapan pengacakan terjadi hingga paket yang diacak sebenarnya tiba. Untuk mempermudah, asumsikan bahwa dekoder digunakan jika trek ditentukan diacak berdasarkan tabel pemetaan program (PMT).

Batasan konfigurasi software

Saat jalur memerlukan dekode aman, pengacak harus berhati-hati saat mengizinkan operasi pengacakan ke dalam buffer yang jelas. Karena decoding audio yang tidak aman diperlukan, jika decoding video memerlukan decoder yang aman, video harus diacak pada sesi yang berbeda dari audio. ECM untuk sesi harus memberi sinyal ke plugin bahwa decoder aman diperlukan.

Atau, plugin harus dapat mengikat kunci ke kebijakan keamanannya dengan andal. Jika tidak, aplikasi dapat dengan mudah mendapatkan frame video dengan pengacak audio.

Meskipun sesi memerlukan dekoder yang aman, sesi mungkin diminta untuk menghasilkan sejumlah kecil data untuk menghapus buffer oleh ekstraktor guna memproses header PES. Untuk mencegah aplikasi berbahaya membuat plugin menampilkan seluruh unit akses, plugin harus mem-parse payload transport untuk memastikan bahwa payload dimulai dengan header PES dari jenis streaming yang sesuai. Jika tidak, plugin harus menolak permintaan.

Urutan penyesuaian CA

Saat menyetel ke channel baru, modul TIS mendaftar untuk menerima deskriptor CA, ECM, dan EMM dari framework PSI Tuner. Deskriptor CA berisi ID sistem CA, yang secara unik mengidentifikasi vendor CA tertentu dan data khusus vendor lainnya. TIS mengkueri Media CAS untuk menentukan apakah ada plugin CAS yang dapat menangani deskriptor CA.

Diagram penyesuaian konten CAS.

Gambar 3. Menyesuaikan konten CAS

Jika ID sistem CA didukung, instance Media CAS akan dibuat dan data pribadi vendor dari deskriptor CA akan diberikan ke plugin. Kemudian, sesi baru dibuka di Media CAS untuk menangani aliran audio dan video. Sesi yang baru dibuka menerima ECM dan EMM untuk plugin.

Contoh alur plugin CAS

TIS mengirimkan ECM ke plugin CAS menggunakan Media CAS API. ECM berisi kata kontrol terenkripsi, yang perlu didekripsi menggunakan informasi dari EMM. Plugin CAS menentukan cara mendapatkan EMM untuk aset berdasarkan informasi khusus vendor dalam deskriptor CA, yang disediakan oleh metode setPrivateData().

EMM dapat dikirimkan dalam band di aliran konten atau di luar band menggunakan permintaan jaringan yang dimulai oleh plugin CA. TIS menggunakan metode processEMM() untuk mengirimkan EMM dalam band apa pun ke plugin CA.

Jika permintaan jaringan diperlukan untuk mendapatkan EMM, plugin CA bertanggung jawab untuk melakukan transaksi jaringan dengan server lisensi.

Diagram contoh CAS.

Gambar 4. Contoh plugin CAS untuk pemrosesan EMM dan ECM

Saat EMM diterima, plugin CA akan mem-parsingnya untuk mendapatkan kunci terenkripsi untuk mendekripsi kata kontrol. Kunci EMM terenkripsi dan kata kontrol terenkripsi dapat dimuat ke dalam tangga kunci atau lingkungan tepercaya untuk melakukan dekripsi kata kontrol dan penguraian berikutnya dari aliran konten.

Media CAS Java API

Media CAS Java API berisi metode berikut.

  • Mencantumkan semua plugin CA yang tersedia di perangkat.

    class MediaCas.PluginDescriptor {
  public String getName();
  public int getSystemId();
}
static PluginDescriptor[] enumeratePlugins();

  • Buat instance Media CAS untuk sistem CA yang ditentukan. Artinya, framework Media CAS dapat menangani beberapa sistem CAS secara bersamaan.

    MediaCas(int CA_system_id);
MediaCas(@NonNull Context context, int casSystemId,
         @Nullable String tvInputServiceSessionId,
         @PriorityHintUseCaseType int priorityHint);

  • Mendaftarkan pemroses peristiwa dan mengizinkan aplikasi untuk menentukan pengendali yang menggunakan looper.

    interface MediaCas.EventListener {
  void onEvent(MediaCas, int event, int arg, byte[] data);
  void onSessionEvent(@NonNull MediaCas mediaCas, @NonNull Session session, int event, int arg, @Nullable byte[] data);
  void onPluginStatusUpdate(@NonNull MediaCas mediaCas, @PluginStatus int status, int arg);
  void onResourceLost(@NonNull MediaCas mediaCas);
}
void setEventListener(MediaCas.EventListener listener, Handler handler);

  • Kirim data pribadi untuk sistem CA. Data pribadi dapat berasal dari deskriptor CA, tabel akses bersyarat, atau sumber di luar band. Hal ini tidak dikaitkan dengan sesi tertentu.

    void setPrivateData(@NonNull byte[] data);

  • Memproses paket EMM.

    void processEmm(@NonNull byte[] data, int offset, int length);

  • Mengirim peristiwa ke sistem CA. Format acara khusus untuk skema dan buram untuk framework.

    void sendEvent(int event, int arg, @Nullable byte[] data);

  • Memulai operasi penyediaan jenis yang ditentukan untuk sistem CA. Saat mendaftar ke layanan TV berbayar untuk pertama kalinya, perangkat harus disediakan ke server CAS terlebih dahulu. Berikan serangkaian parameter terkait ke perangkat untuk penyediaan.

    void provision(String provisionString);

  • Memicu pembaruan hak. Saat pengguna berlangganan ke saluran baru (misalnya, dengan merespons iklan atau dengan menambahkan saluran di panduan program elektronik (EPG)), aplikasi harus dapat memberi tahu klien CA untuk memperbarui kunci hak.

    void refreshEntitlements(int refreshType);

  • Tutup objek Media CAS.

    void close();

  • Buka sesi.

    Session openSession();
Session openSession(@SessionUsage int sessionUsage, @ScramblingMode int scramblingMode);

  • Menutup sesi yang sebelumnya dibuka.

    void Session#close();

  • Memberikan data pribadi CA dari deskriptor CA di PMT, yang dapat berasal dari bagian info program atau info ES, ke sesi CAS.

    void Session#setPrivateData(@NonNull byte[] sessionId, @NonNull byte[] data);

  • Memproses paket ECM untuk sesi.

    void Session#processEcm(@NonNull byte[] data, int offset, int length);

  • Dapatkan ID sesi.

    byte[] Session#getSessionId();

  • Mengirim peristiwa sesi ke sistem CA. Format peristiwa khusus untuk skema dan tidak transparan bagi framework.

    void Session#sendSessionEvent(int event, int arg, @Nullable byte[] data);