مشاركة عبر

إرشادات الترحيل المستندة إلى سيناريو حماية المحتوى

  • مقالة

شعار دليل الترحيل

خطوات الترحيل 2

هام

لم يعد من الضروري الترحيل من Azure Media Service v2 إلى v3 لأن إهمال V2 API سيتوافق مع إيقاف Azure Media Services. يرجى الاطلاع على دليل إيقاف Azure Media Services لمزيد من المعلومات.

توفر لك هذه المقالة تفاصيل وإرشادات حول ترحيل حالات استخدام حماية المحتوى من v2 API إلى Azure Media Services الإصدار 3 API الجديد.

حماية المحتوى في الإصدار 3 API

راجع مفاهيم حماية المحتوى والبرامج التعليمية وكيفية الإرشاد في نهاية هذه المقالة لخطوات محددة.

ملاحظة

يناقش الجزء المتبقي من هذه المقالة كيف يمكنك ترحيل حماية المحتوى من الإصدار 2 إلى الإصدار 3 باستخدام .NET. إذا كنت بحاجة إلى إرشادات أو نموذج تعليمة برمجية للغة أو طريقة مختلفة، فالرجاء إنشاء مشكلة GitHub لهذه الصفحة.

إهمال AMS كخادم تسليم ترخيص مستقل (الوضع المحلي المختلط)

لم تعد واجهة برمجة التطبيقات v3 تدعم استخدام خدمات تسليم المفاتيح كميزة قائمة بذاتها لحماية المحتوى حيث يمكن استخدام خدمة تسليم المفاتيح لتقديم ترخيص للمحتوى الذي يتم دفقه أو تسليمه من خلال خوادم الأصل الأخرى التابعة لجهة خارجية. وهذا يعني أن AMS لم يعد يدعم سيناريوهات تسليم المفاتيح فقط في V3 API، ويتطلب منك الدفق من خدمات أصل AMS باستخدام التعبئة والتغليف الديناميكي والتشفير عند التسليم باستخدام v3.

سيستمر المحتوى الحالي الذي تم تشفيره باستخدام v2 API ويتم تسليمه في نموذج "مختلط" في العمل (ستظل المفاتيح قابلة للاسترداد على مستوى البيانات)، ولكن إدارة هذه المفاتيح (التحديثات والتحريرات) من خلال مستوى إدارة v2 أو مستوى إدارة v3 لن تعمل بعد 29 فبراير 2024.

ملاحظة

ستدعم جميع المحتويات الجديدة التي يتم تسليمها باستخدام الإصدار 3 حماية المحتوى والتدفق من AMS فقط ولن تدعم الوضع "المختلط". سيستمر مستوى البيانات في تقديم المفاتيح والتراخيص الموجودة التي تم إنشاؤها في v2، ولكنه لن يدعم الإدارة أو التحديثات من خلال v2 أو v3 API.

الإصدار 3 رؤية v2 الأصول، StreamingLocators، والخصائص

في v2 API، تم استخدام Assets وStreamingLocators وContentKeys لحماية محتوى البث الخاص بك. عند الترحيل إلى الإصدار 3 API، يتم عرض v2 API Assets وStreamingLocators وContentKeys تلقائياً في الإصدار 3 API وستتوفر لك جميع البيانات الموجودة عليها للوصول إليها.

ومع ذلك، لا يمكنك تحديث أي خصائص في كيانات الإصدار 2 من خلال الإصدار 3 API التي تم إنشاؤها في الإصدار 2.

إذا كنت بحاجة إلى تحديث أو تغيير المحتوى المخزن في كيانات الإصدار 2، فقم بتحديثها باستخدام v2 API أو إنشاء كيانات الإصدار 3 API جديدة لترحيلها.

اختلافات معرف الأصول

للترحيل، ستحتاج إلى الوصول إلى الخصائص أو مفاتيح المحتوى من أصول v2. من المهم أن نفهم أن v2 API تستخدم AssetId كمفتاح تعريف أساسي ولكن واجهة برمجة تطبيقات الإصدار 3 الجديدة تستخدم اسم إدارة موارد Azure للكيان باعتباره المعرف الأساسي. (لا يتم استخدام الخاصية v2 Asset.Name كمعرف فريد.) باستخدام v3 API، يظهر اسم أصل v2 الآن ك Asset.Description.

على سبيل المثال، إذا كان لديك سابقاً أصل v2 بمعرف nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8، يكون المعرف الآن في نهاية GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. سترى هذا عند إدراج أصول v2 الخاصة بك من خلال الإصدار 3 API.

أي أصول تم إنشاؤها ونشرها باستخدام v2 API سيكون لها كلاً من ContentKeyPolicy وContentKey في الإصدار 3 API بدلاً من نهج مفتاح المحتوى الافتراضية في StreamingPolicy.

لمزيد من المعلومات، راجع وثائق نهج مفتاح المحتوى ووثائق نهج البث.

استخدم أدوات Azure Media Services Explorer (AMSE) v2 وAMSE الإصدار 3 جنباً إلى جنب

استخدم v2 Azure Media Services Explorer tool جنباً إلى جنب مع الإصدار 3 Azure Media Services Explorer tool لمقارنة البيانات جنباً إلى جنب مع الأصل الذي تم إنشاؤه ونشره عبر v2 APIs. يجب أن تكون جميع الخصائص مرئية، ولكن في مواقع مختلفة.

استخدم نموذج ترحيل حماية محتوى .NET

يمكنك العثور على نموذج تعليمة برمجية لمقارنة الاختلافات في معرفات الأصول باستخدام v2toالإصدار 3MigrationSample ضمن ContentProtection في نماذج التعليمة البرمجية Media Services.

قائمة محددات البث

يمكنك الاستعلام عن StreamingLocators المرتبط بالأصول التي تم إنشاؤها في v2 API باستخدام طريقة الإصدار 3 الجديدة ListStreamingLocators في كيان الأصول. راجع أيضاً إصدار .NET client SDK من ListStreamingLocatorsAsync

ستوفر لك نتائج طريقة ListStreamingLocatorsName وStreamingLocatorId محدد الموقع بالإضافة إلى StreamingPolicyName.

ابحث عن مفاتيح المحتوى

للعثور على ContentKeys المستخدم مع StreamingLocators، يمكنك استدعاء طريقة StreamingLocator.ListContentKeysAsync.

لمزيد من المعلومات حول حماية المحتوى في الإصدار 3 API، راجع المقالة حماية المحتوى الخاص بك باستخدام التشفير الديناميكي لـ Media Services.

قم بتغيير v2 ContentKeyPolicy مع الاحتفاظ بنفس ContentKey

يجب عليك أولاً إلغاء النشر (إزالة جميع محددات مواقع البث) على الأصل عبر v2 SDK. وفيما يلي كيفية إجراء ذلك:

  1. احذف محدد الموقع.
  2. قم بفك ارتباط ContentKeyAuthorizationPolicy.
  3. قم بفك ارتباط AssetDeliveryPolicy.
  4. قم بفك ارتباط ContentKey.
  5. احذف ملف ContentKey.
  6. أنشئ StreamingLocator جديداً في الإصدار 3 باستخدام الإصدار 3 StreamingPolicy وContentKeyPolicy، مع تحديد معرّف مفتاح المحتوى المحدد وقيمة المفتاح المطلوبة.

ملاحظة

من الممكن حذف محدد موقع v2 باستخدام الإصدار 3 API، لكن هذا لن يزيل مفتاح المحتوى أو نهج مفتاح المحتوى إذا تم إنشاؤها في v2 API.

مفاهيم حماية المحتوى والبرامج التعليمية وكيفية الإرشاد

المفاهيم

البرامج التعليمية

البدء السريع: استخدم المدخل لتشفير المحتوى

الدلائل الإرشادية

الأدوات

الحصول على التعليمات والدعم

يمكنك الاتصال بخدمات الوسائط بأسئلة أو اتباع تحديثاتنا بإحدى الطرق التالية: