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

  • مقالة
  • قراءة خلال 3 دقائق

migration guide logo

migration steps 2

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

حماية المحتوى في v3 API

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

ملاحظة

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

رؤية v3 للأصول v2 و StreamingLocators والخصائص

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

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

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

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

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

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

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

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

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

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

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

يمكنك العثور على نموذج تعليمات برمجية لمقارنة الاختلافات في معرفات الأصول باستخدام v2tov3MigrationSample ضمن ContentProtection في نماذج التعليمات البرمجية لخدمات الوسائط.

سرد محددات مواقع البث

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

ستوفر لك نتائج ListStreamingLocators الأسلوب و StreamingLocatorId من محدد الموقع جنبا إلى جنب مع StreamingPolicyName.Name

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

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

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

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

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

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

ملاحظة

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

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

المفاهيم

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

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

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

عينات

الأدوات