العمل مع MediaPlayer وإدارة الحقوق الرقمية (DRM)

بدءًا من Android 8.0 (المستوى 26 من واجهة برمجة التطبيقات)، يتضمّن MediaPlayer واجهات برمجة تطبيقات تتيح تشغيل المواد المحمية بإدارة الحقوق الرقمية. تشبه واجهات برمجة تطبيقات إدارة الحقوق الرقمية في MediaPlayer واجهة برمجة التطبيقات ذات المستوى المنخفض التي يوفّرها MediaDrm، ولكنّها تعمل على مستوى أعلى ولا تُعرِض عناصر الاستخراج وإدارة الحقوق الرقمية والتشفير الأساسية.

على الرغم من أنّ MediaPlayer DRM API لا توفّر الوظائف الكاملة لسمة MediaDrm، إلا أنّها تتوافق مع حالات الاستخدام الأكثر شيوعًا. يمكن للتنفيذ الحالي التعامل مع أنواع المحتوى التالية:

• ملفات الوسائط المحلية المحمية بتقنية Widevine
• ملفات الوسائط المتوفّرة للبث أو المحتوى المتوفّر عن بُعد المحمي بتقنية Widevine

يوضّح مقتطف الرمز البرمجي التالي كيفية استخدام طرق إدارة الحقوق الرقمية MediaPlayer الجديدة في عملية التنفيذ المتزامنة.

لإدارة الوسائط التي تخضع لإدارة إدارة الحقوق الرقمية (DRM)، عليك تضمين الطرق الجديدة إلى جانب المسار المعتاد لطلبات MediaPlayer، كما هو موضّح في هذا المثال:

mediaPlayer?.apply {
    setDataSource()
    setOnDrmConfigHelper() // optional, for custom configuration
    prepare()
    drmInfo?.also {
        prepareDrm()
        getKeyRequest()
        provideKeyResponse()
    }

    // MediaPlayer is now ready to use
    start()
    // ...play/pause/resume...
    stop()
    releaseDrm()
}

setDataSource();
setOnDrmConfigHelper(); // optional, for custom configuration
prepare();
if (getDrmInfo() != null) {
  prepareDrm();
  getKeyRequest();
  provideKeyResponse();
}

// MediaPlayer is now ready to use
start();
// ...play/pause/resume...
stop();
releaseDrm();

ابدأ بإعداد عنصر MediaPlayer وضبط مصدره باستخدام setDataSource() كالمعتاد. بعد ذلك، اتّبِع الخطوات التالية لاستخدام إدارة الحقوق الرقمية:

1. إذا كنت تريد أن يُجري تطبيقك عملية ضبط مخصّصة، حدِّد واجهة OnDrmConfigHelper، واربطها بالمشغّل باستخدام setOnDrmConfigHelper().
2. يُرجى الاتصال على prepare().
3. يُرجى الاتصال على getDrmInfo(). إذا كان المصدر يتضمّن محتوى مُدارًا بإدارة الحقوق الرقمية، تُرجِع الطريقة قيمة MediaPlayer.DrmInfo غير صفرية.

إذا كان MediaPlayer.DrmInfo متوفّرًا:

1. راجِع خريطة معرّفات UUID المتاحة واختَر معرّفًا.
2. حضِّر إعدادات إدارة الحقوق الرقمية للمصدر الحالي من خلال الاتصال بـ prepareDrm().
   • إذا أنشأت وسجلت طلب معاودة اتصال OnDrmConfigHelper، يتم استدعاؤه أثناء تنفيذ prepareDrm(). يتيح لك ذلك إجراء إعداد مخصّص لخصائص إدارة الحقوق الرقمية قبل فتح جلسة إدارة الحقوق الرقمية. يتم استدعاء دالة الاستدعاء بشكل متزامن في سلسلة المحادثات التي استدعت prepareDrm(). للوصول إلى خصائص إدارة الحقوق الرقمية، يُرجى الاتصال بالرقمَين getDrmPropertyString() وsetDrmPropertyString(). تجنَّب تنفيذ عمليات طويلة.
   • إذا لم يتم إعداد الجهاز بعد، يدخل prepareDrm() أيضًا إلى خادم الإعداد لإعداد الجهاز. يمكن أن تستغرق هذه العملية مدّة زمنية متغيرة، وذلك استنادًا إلى إمكانية الاتصال بالشبكة.
3. للحصول على صفيف بايت لطلب مفتاح غير شفاف لإرساله إلى خادم الترخيص، يمكنك الاتصال بـ getKeyRequest().
4. لإعلام محرّك إدارة الحقوق الرقمية (DRM) باستجابة المفتاح التي تم تلقّيها من ملف الترخيص الخادم، اتصل بالرقم provideKeyResponse(). تعتمد النتيجة على نوع طلب المفتاح:
   • إذا كان الردّ على طلب مفتاح بلا إنترنت، تكون النتيجة معرّفًا لسلسلة مفاتيح. يمكنك استخدام معرّف مجموعة المفاتيح هذا مع restoreKeys() لاستعادة المفاتيح إلى جلسة جديدة.
   • إذا كان الردّ على طلب بث أو إصدار، تكون النتيجة null.

إعداد إدارة الحقوق الرقمية بشكل غير متزامن

يتم تشغيل prepareDrm() بشكل متزامن تلقائيًا، ما يؤدي إلى حظر المحتوى إلى أن تنتهي عملية الإعداد. ومع ذلك، قد يتطلّب الإعداد الأوّل لنظام إدارة الحقوق الرقمية على جهاز جديد أيضًا عملية توفير تُجريها prepareDrm() داخليًا، وقد يستغرق اكتمالها بعض الوقت بسبب عملية تشغيل الشبكة المعنيّة. يمكنك تجنُّب الحظر على prepareDrm() من خلال تحديد MediaPlayer.OnDrmPreparedListener وضبطه.

اضبط OnDrmPreparedListener. ينفِّذ prepareDrm() عملية الإعداد (إذا لزم الأمر) والتحضير في الخلفية. عند اكتمال عملية الإعداد والتحضير، يتصل النظام بالمستمع. لا تفترض أيًا من الافتراضات حول تسلسل الاستدعاء أو سلسلة المهام التي يتم فيها تشغيل أداة الاستماع (ما لم تسجِّل أداة الاستماع في سلسلة مهام معالِج). يمكن للنظام استدعاء المستمع قبل أو بعد إرجاع prepareDrm().

إعداد إدارة الحقوق الرقمية بشكل غير متزامن

يمكنك إعداد إدارة الحقوق الرقمية بشكل غير متزامن من خلال إنشاء وتسجيل الرسالة MediaPlayer.OnDrmInfoListener لإعداد إدارة الحقوق الرقمية والرسالة MediaPlayer.OnDrmPreparedListener لبدء تشغيل المشغّل. وتعمل هذه السمات مع prepareAsync()، كما هو موضّح في هذا المثال:

setOnPreparedListener()
setOnDrmInfoListener()
setDataSource()
prepareAsync()
// ...

// If the data source content is protected you receive a call to the onDrmInfo() callback.
override fun onDrmInfo(mediaPlayer: MediaPlayer, drmInfo: MediaPlayer.DrmInfo) {
    mediaPlayer.apply {
        prepareDrm()
        getKeyRequest()
        provideKeyResponse()
    }
}

// When prepareAsync() finishes, you receive a call to the onPrepared() callback.
// If there is a DRM, onDrmInfo() sets it up before executing this callback,
// so you can start the player.
override fun onPrepared(mediaPlayer: MediaPlayer) {
    mediaPlayer.start()
}

setOnPreparedListener();
setOnDrmInfoListener();
setDataSource();
prepareAsync();
// ...

// If the data source content is protected you receive a call to the onDrmInfo() callback.
onDrmInfo() {
  prepareDrm();
  getKeyRequest();
  provideKeyResponse();
}

// When prepareAsync() finishes, you receive a call to the onPrepared() callback.
// If there is a DRM, onDrmInfo() sets it up before executing this callback,
// so you can start the player.
onPrepared() {

start();
}

التعامل مع الوسائط المشفّرة

بدءًا من Android 8.0 (المستوى 26 من واجهة برمجة التطبيقات)، يمكن لنظام التشغيل MediaPlayer أيضًا فك تشفير محتوى الوسائط المشفَّر على مستوى عيّنة ملف Common Encryption Scheme (CENC) وHLS (METHOD=SAMPLE-AES) لأنواع البث الأساسي H.264 وAAC. كان من الممكن سابقًا استخدام الوسائط المشفَّرة بالكامل (METHOD=AES-128).

مزيد من المعلومات

‫Jetpack Media3 هو الحلّ المُقترَح لتشغيل الوسائط في تطبيقك. اطّلِع على مزيد من المعلومات حوله.

تتناول هذه الصفحات مواضيع تتعلّق بتسجيل المحتوى الصوتي والفيديو وتخزينه وتشغيله:

• تنسيقات الوسائط المتوافقة
• MediaRecorder
• تخزين البيانات