Sdílet prostřednictvím

Pokyny k migraci na základě scénáře ochrany obsahu

  • Článek

Logo průvodce migrací

kroky migrace 2

Důležité

Už není nutné migrovat z Azure Media Service v2 na verzi 3, protože vyřazení rozhraní API V2 bude v souladu s vyřazením služby Azure Media Services. Další informace najdete v průvodci vyřazením ze služby Azure Media Services .

Tento článek obsahuje podrobnosti a pokyny k migraci případů použití ochrany obsahu z rozhraní API v2 na nové rozhraní API služby Azure Media Services v3.

Ochrana obsahu v rozhraní API v3

Konkrétní kroky najdete v tématu Koncepty ochrany obsahu, kurzy a návody na konci tohoto článku.

Poznámka

Zbývající část tohoto článku popisuje, jak můžete migrovat ochranu obsahu v2 do verze 3 pomocí .NET. Pokud potřebujete pokyny nebo ukázkový kód pro jiný jazyk nebo metodu, vytvořte problém na GitHubu pro tuto stránku.

Vyřazení AMS jako samostatného serveru pro doručování licencí (hybridní místní režim)

Rozhraní API v3 už nepodporuje použití služeb doručování klíčů jako samostatné funkce pro ochranu obsahu, kde službu doručování klíčů lze použít k doručování licencí k obsahu streamovaného nebo doručovaného prostřednictvím jiných serverů původu třetích stran. To znamená, že AMS už v rozhraní API V3 nepodporuje scénáře pouze pro doručování klíčů a při doručování s v3 vyžaduje streamování ze služeb původu AMS pomocí dynamického balení a šifrování.

Stávající obsah, který byl zašifrovaný pomocí rozhraní API v2 a je dodáván v hybridním modelu, bude dál fungovat (klíče se budou dál načítat v rovině dat), ale správa těchto klíčů (aktualizace a úpravy) prostřednictvím roviny správy v2 nebo roviny správy v3 už po 29. únoru 2024 nebude fungovat.

Poznámka

Veškerý nový obsah dodávaný pomocí verze 3 bude podporovat pouze ochranu obsahu a streamování z AMS a už nepodporuje hybridní režim. Rovina dat bude i nadále doručovat stávající klíče a licence vytvořené ve verzi 2, ale už nebude podporovat správu ani aktualizace prostřednictvím rozhraní API verze 2 nebo v3.

Viditelnost prostředků v2, StreamLocators a vlastností v3

V rozhraní API AssetsStreamingLocatorsverze 2 se k ochraně streamovaného obsahu používaly , aContentKeys. Při migraci na rozhraní API v3 se všechna rozhraní API AssetsStreamingLocatorsverze 2 , a ContentKeys automaticky zveřejňují v rozhraní API verze 3 a všechna data na nich jsou k dispozici pro přístup.

Nelze však aktualizovat žádné vlastnosti entit v2 prostřednictvím rozhraní API v3, které byly vytvořeny ve verzi 2.

Pokud potřebujete aktualizovat, změnit nebo změnit obsah uložený v entitách v2, aktualizujte je pomocí rozhraní API v2 nebo vytvořte nové entity rozhraní API v3, abyste je mohli migrovat.

Rozdíly v identifikátorech prostředků

Pokud chcete migrovat, budete muset z prostředků v2 přistupovat k vlastnostem nebo klíčům obsahu. Je důležité si uvědomit, že rozhraní API verze 2 používá AssetId jako primární identifikační klíč, ale nové rozhraní API verze 3 používá název Azure Resource Management entity jako primární identifikátor. (Vlastnost v2 Asset.Name se nepoužívá jako jedinečný identifikátor.) U rozhraní API v3 se teď název prostředku v2 zobrazí jako Asset.Description.

Pokud jste například dříve měli prostředek v2 s ID nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, je teď identifikátor na konci identifikátoru GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Uvidíte to při výpisu prostředků v2 prostřednictvím rozhraní API v3.

Všechny prostředky vytvořené a publikované pomocí rozhraní API v2 budou mít v rozhraní API verze 3 místo ContentKeyPolicyContentKey výchozích zásad StreamingPolicyklíče obsahu na .

Další informace najdete v dokumentaci k zásadám klíče obsahu a v dokumentaci k zásadám streamování .

Použití nástrojů Azure Media Services Explorer (AMSE) v2 a AMSE v3 vedle sebe

Pomocí nástroje Azure Media Services Explorer v2 spolu s nástrojem Azure Media Services Explorer v3 můžete porovnat data vedle prostředku vytvořeného a publikovaného prostřednictvím rozhraní API v2. Všechny vlastnosti by měly být viditelné, ale v různých umístěních.

Použití ukázky migrace ochrany obsahu .NET

Ukázku kódu pro porovnání rozdílů v identifikátorech prostředků pomocí v2tov3MigrationSample najdete v části ContentProtection v ukázkách kódu Media Services.

Výpis lokátorů streamování

Na objekty přidružené k prostředkům vytvořeným v rozhraní API verze 2 můžete dotazovat StreamingLocators pomocí nové metody ListStreamingLocators v3 v entitě Asset. Odkazujte také na verzi klientské sady SDK rozhraní .NET nástroje ListStreamingLocatorsAsync.

Výsledky ListStreamingLocators metody vám spolu s lokátorem Name poskytnou a StreamingLocatorId lokátoru StreamingPolicyName.

Vyhledání klíčů obsahu

Pokud chcete najít použité s ContentKeys vaším StreamingLocators, můžete volat StreamingLocator.ListContentKeysAsync metoda.

Další informace o ochraně obsahu v rozhraní API v3 najdete v článku Ochrana obsahu pomocí dynamického šifrování Media Services.

Změňte zásadu ContentKey v2 a ponechte stejnou zásadu ContentKey.

Nejprve byste měli zrušit publikování (odebrat všechny lokátory streamování) na assetu prostřednictvím sady SDK v2. Jak na to:

  1. Odstraňte lokátor.
  2. Zrušte propojení .ContentKeyAuthorizationPolicy
  3. Zrušte propojení .AssetDeliveryPolicy
  4. Zrušte propojení .ContentKey
  5. Odstraňte objekt ContentKey.
  6. Vytvořte nový StreamingLocator ve verzi 3 pomocí v3 StreamingPolicy a ContentKeyPolicy, se zadáním konkrétního identifikátoru klíče obsahu a požadované hodnoty klíče.

Poznámka

Lokátor v2 je možné odstranit pomocí rozhraní API v3, ale neodeberete tím klíč obsahu ani zásadu klíče obsahu, pokud byly vytvořeny v rozhraní API v2.

Koncepty ochrany obsahu, kurzy a návody

Koncepty

Kurzy

Rychlý start: Šifrování obsahu pomocí portálu

Průvodce postupy

Nástroje

Získání nápovědy a podpory

Media Services můžete kontaktovat s dotazy nebo sledovat naše aktualizace jedním z následujících způsobů: