Vägledning för migrering för att flytta från Media Services v2 till v3Migration guidance for moving from Media Services v2 to v3

Bli informerad om när du ska gå tillbaka till den här sidan för uppdateringar genom att kopiera och klistra in URL: en: https://docs.microsoft.com/api/search/rss?search=%22Migrate+from+Azure+Media+Services+v2+to+v3%22&locale=en-us i din RSS-feeds läsare.Get notified about when to revisit this page for updates by copying and pasting this URL: https://docs.microsoft.com/api/search/rss?search=%22Migrate+from+Azure+Media+Services+v2+to+v3%22&locale=en-us into your RSS feed reader.

Den här artikeln beskriver ändringar som introducerades i Azure Media Services v3, Visar skillnader mellan två versioner och ger vägledning om migrering.This article describes changes that were introduced in Azure Media Services v3, shows differences between two versions, and provides the migration guidance.

Om du har en video tjänst som utvecklats idag ovanpå de äldre Media Services v2-API: ernabör du läsa följande rikt linjer och överväganden innan du migrerar till v3-API: erna.If you have a video service developed today on top of the legacy Media Services v2 APIs, you should review the following guidelines and considerations prior to migrating to the v3 APIs. Det finns många fördelar och nya funktioner i v3-API: et som förbättrar utvecklings upplevelsen och funktionerna i Media Services.There are many benefits and new features in the v3 API that improve the developer experience and capabilities of Media Services. Som du ser i avsnittet kända problem i den här artikeln finns det också vissa begränsningar på grund av ändringar mellan API-versionerna.However, as called out in the Known Issues section of this article, there are also some limitations due to changes between the API versions. Den här sidan kommer att behållas när Media Servicess teamet gör fortsatta förbättringar av v3-API: erna och åtgärdar luckorna mellan versionerna.This page will be maintained as the Media Services team makes continued improvements to the v3 APIs and addresses the gaps between the versions.

Anteckning

För närvarande kan du inte hantera v3-resurser med Azure-portalen.Currently, you cannot use the Azure portal to manage v3 resources. Använd REST API, CLI eller en av SDK:erna som stöds.Use the REST API, CLI, or one of the supported SDKs.

Fördelar med Media Services v3Benefits of Media Services v3

API är mer lättare att nåAPI is more approachable

  • v3 baseras på en enhetlig API-yta som innehåller funktioner för både hantering och åtgärder som skapats på Azure Resource Manager.v3 is based on a unified API surface, which exposes both management and operations functionality built on Azure Resource Manager. Azure Resource Manager mallar kan användas för att skapa och distribuera transformeringar, slut punkter för direkt uppspelning, Live-händelser och mycket annat.Azure Resource Manager templates can be used to create and deploy Transforms, Streaming Endpoints, Live Events, and more.
  • Openapi-specifikation (tidigare kallat Swagger)- dokument.OpenAPI Specification (formerly called Swagger) document. Exponerar schemat för alla tjänst komponenter, inklusive filbaserad kodning.Exposes the schema for all service components, including file-based encoding.
  • SDK: er är tillgängliga för .net, .net Core, Node. js, python, Java, Gooch Ruby.SDKs available for .NET, .NET Core, Node.js, Python, Java, Go, and Ruby.
  • Azure CLI -integrering för enkel skript support.Azure CLI integration for simple scripting support.

Nya funktionerNew features

  • För filbaserad jobb bearbetning kan du använda en HTTP (S)-URL som indata.For file-based Job processing, you can use a HTTP(S) URL as the input.
    Du behöver inte ha något innehåll som redan är lagrat i Azure, eller så behöver du inte skapa till gångar.You do not need to have content already stored in Azure, nor do you need to create Assets.
  • Introducerar begreppet transformeringar för filbaserad jobb bearbetning.Introduces the concept of Transforms for file-based Job processing. En transformering kan användas för att skapa återanvändbara konfigurationer, skapa Azure Resource Manager mallar och isolera bearbetnings inställningar mellan flera kunder eller klienter.A Transform can be used to build reusable configurations, to create Azure Resource Manager Templates, and isolate processing settings between multiple customers or tenants.
  • En till gång kan ha flera positioner för strömning med olika inställningar för dynamisk paketering och dynamisk kryptering.An Asset can have multiple Streaming Locators each with different Dynamic Packaging and Dynamic Encryption settings.
  • Innehålls skydd stöder flera viktiga funktioner.Content protection supports multi-key features.
  • Du kan strömma direktsända händelser som är upp till 24 timmar långt när du använder Media Services för att avkoda en enskild bit i ett bidrags flöde för en bit hastighet till en utdataström som har flera bit hastigheter.You can stream Live Events that are up to 24 hours long when using Media Services for transcoding a single bitrate contribution feed into an output stream that has multiple bitrates.
  • Ny support för Live-direktuppspelning med låg latens för Live-händelser.New Low Latency live streaming support on Live Events. Mer information finns i svars tid.For more information, see latency.
  • För hands versionen av live event stöder dynamisk paketering och dynamisk kryptering.Live Event Preview supports Dynamic Packaging and Dynamic Encryption. Detta aktiverar innehålls skydd för för hands versionen samt streck-och HLS-paket.This enables content protection on Preview as well as DASH and HLS packaging.
  • Live-utdata är enklare att använda än entiteten program i v2-API: erna.Live Output is simpler to use than the Program entity in the v2 APIs.
  • Förbättrat stöd för RTMP (ökad stabilitet och fler stöd för käll kodare).Improved RTMP support (increased stability and more source encoder support).
  • RTMPs säker inmatning.RTMPS secure ingest.
    När du skapar en Live-händelse får du 4 inmatnings-URL: er.When you create a Live Event, you get 4 ingest URLs. De 4 inmatnings-URL: erna är nästan identiska, har samma strömnings-token (AppId), men endast port nummer delen är annorlunda.The 4 ingest URLs are almost identical, have the same streaming token (AppId), only the port number part is different. Två av URL: erna är primära och säkerhets kopiering för RTMP.Two of the URLs are primary and backup for RTMPS.
  • Du har rollbaserad åtkomst kontroll (RBAC) över dina entiteter.You have role-based access control (RBAC) over your entities.

Ändringar från v2Changes from v2

  • För till gångar som skapats med v3 stöder Media Services endast lagrings kryptering Azure Storage på Server sidan.For assets created with v3, Media Services supports only the Azure Storage server-side storage encryption.
    • Du kan använda v3-API: er med till gångar som skapats med v2-API: er med lagrings kryptering (AES 256) som tillhandahålls av Media Services.You can use v3 APIs with Assets created with v2 APIs that had storage encryption (AES 256) provided by Media Services.
    • Du kan inte skapa nya till gångar med äldre AES 256- lagrings kryptering med hjälp av v3-API: er.You cannot create new Assets with the legacy AES 256 storage encryption using v3 APIs.
  • Till gångensegenskaper i v3 skiljer sig åt från v2, se hur egenskaper mappas.The Asset's properties in v3 differ to from v2, see how the properties map.
  • V3 SDK: er är nu frikopplade från Storage SDK, vilket ger dig mer kontroll över vilken version av Storage SDK som du vill använda och undviker versions problem.The v3 SDKs are now decoupled from the Storage SDK, which gives you more control over the version of Storage SDK you want to use and avoids versioning issues.
  • I v3-API: erna är alla kodnings bit hastigheter i bitar per sekund.In the v3 APIs, all of the encoding bit rates are in bits per second. Detta skiljer sig från inställningarna för v2-Media Encoder Standard.This is different than the v2 Media Encoder Standard presets. Bit hastigheten i v2 skulle till exempel anges som 128 (kbps), men i v3 skulle den bli 128000 (bitar/sekund).For example, the bitrate in v2 would be specified as 128 (kbps), but in v3 it would be 128000 (bits/second).
  • Entiteterna AssetFiles, AccessPolicies och IngestManifests finns inte i v3.Entities AssetFiles, AccessPolicies, and IngestManifests do not exist in v3.
  • Egenskapen IAsset. ParentAssets finns inte i v3.The IAsset.ParentAssets property does not exist in v3.
  • ContentKeys är inte längre en entitet, det är nu en egenskap för den strömmande lokaliseraren.ContentKeys is no longer an entity, it is now a property of the Streaming Locator.
  • Event Grid-support ersätter NotificationEndpoints.Event Grid support replaces NotificationEndpoints.
  • Följande entiteter har bytt namnThe following entities were renamed
    • Jobbets utdata ersätter uppgift och ingår nu i ett jobb.Job Output replaces Task, and is now part of a Job.
    • Streaming Locator ersätter Locator.Streaming Locator replaces Locator.
    • Live Event ersätter kanal.Live Event replaces Channel.
      Faktureringen av Live-händelser baseras på Live Channel-mätare.Live Events billing is based on Live Channel meters. Mer information finns i fakturering och priser.For more information, see billing and pricing.
    • Live output ersätter program.Live Output replaces Program.
  • Liveutdata startar när de skapas och avbryts när de tas bort.Live Outputs start on creation and stop when deleted. Program fungerade annorlunda i v2-API: er, de var igång när de har skapats.Programs worked differently in the v2 APIs, they had to be started after creation.
  • Om du vill hämta information om ett jobb måste du känna till Transformations namnet som jobbet skapades under.To get information about a job, you need to know the Transform name under which the job was created.
  • I v2 skapas filer för XML- indata och utdata som genereras som ett resultat av ett kodnings jobb.In v2, XML input and output metadata files get generated as the result of an encoding job. I v3 har metadata-formatet ändrats från XML till JSON.In v3, the metadata format changed from XML to JSON.

Anteckning

Granska de namngivnings konventioner som tillämpas på Media Services v3-resurser.Review the naming conventions that are applied to Media Services v3 resources. Granska också namngivning av blobbar.Also review naming blobs.

Funktions luckor med avseende på v2-API: erFeature gaps with respect to v2 APIs

V3-API: et har följande funktions luckor i relation till v2-API: et.The v3 API has the following feature gaps with respect to the v2 API. Att stänga luckorna är pågående arbete.Closing the gaps is work in progress.

  • Premium-kodaren och de äldre Media Analytics-processorerna (Azure Media Services indexerare 2 för hands version, ansikts bortredigering osv.) är inte tillgängliga via v3.The Premium Encoder and the legacy media analytics processors (Azure Media Services Indexer 2 Preview, Face Redactor, etc.) are not accessible via v3.
    Kunder som vill migrera från Media Indexer 1 eller 2 för hands versionen kan omedelbart använda AudioAnalyzer-förvalet i v3-API: et.Customers who wish to migrate from the Media Indexer 1 or 2 preview can immediately use the AudioAnalyzer preset in the v3 API. Den här nya för inställningen innehåller fler funktioner än den äldre Media Indexer 1 eller 2.This new preset contains more features than the older Media Indexer 1 or 2.

  • Många av de avancerade funktionerna i Media Encoder Standard i v2 API: er är för närvarande inte tillgängliga i v3, till exempel:Many of the advanced features of the Media Encoder Standard in v2 APIs are currently not available in v3, such as:

    • Häftning av till gångarStitching of Assets
    • ÖverläggOverlays
    • BeskärningCropping
    • Miniatyr spritThumbnail Sprites
    • Infoga ett tyst ljud spår när indata inte har något ljudInserting a silent audio track when input has no audio
    • Infoga ett video spår när inmatningen saknar videoInserting a video track when input has no video
  • Live-händelser med omkodning stöder för närvarande inte mellanliggande infogning och infogning av AD-markörer via API-anrop.Live Events with transcoding currently do not support Slate insertion mid-stream and ad marker insertion via API call.

Anteckning

Skriv bok märke till den här artikeln och fortsätt att söka efter uppdateringar.Please bookmark this article and keep checking for updates.

Kod skillnaderCode differences

I följande tabell visas kod skillnaderna mellan v2 och v3 för vanliga scenarier.The following table shows the code differences between v2 and v3 for common scenarios.

ScenarioScenario V2-APIV2 API V3-APIV3 API
Skapa en till gång och ladda upp en filCreate an asset and upload a file v2 .NET-exempelv2 .NET example v3 .NET-exempelv3 .NET example
Skicka ett jobbSubmit a job v2 .NET-exempelv2 .NET example v3 .NET-exempelv3 .NET example

Visar hur du först skapar en transformering och sedan skickar ett jobb.Shows how to first create a Transform and then submit a Job.
Publicera en till gång med AES-krypteringPublish an asset with AES encryption 1. skapa ContentKeyAuthorizationPolicyOption1. Create ContentKeyAuthorizationPolicyOption
2. skapa ContentKeyAuthorizationPolicy2. Create ContentKeyAuthorizationPolicy
3. skapa AssetDeliveryPolicy3. Create AssetDeliveryPolicy
4. Skapa till gång och ladda upp innehåll eller skicka jobb och Använd utgående till gång4. Create Asset and upload content OR Submit job and use output asset
5. associera AssetDeliveryPolicy med till gång5. Associate AssetDeliveryPolicy with Asset
6. skapa ContentKey6. Create ContentKey
7. bifoga ContentKey till till gång7. Attach ContentKey to Asset
8. skapa Access policy8. Create AccessPolicy
9. skapa lokaliserare9. Create Locator

v2 .NET-exempelv2 .NET example
1. skapa en princip för innehålls nyckel1. Create Content Key Policy
2. Skapa till gång2. Create Asset
3. Ladda upp innehåll eller använd till gång som JobOutput3. Upload content or use Asset as JobOutput
4. skapa strömmande Locator4. Create Streaming Locator

v3 .NET-exempelv3 .NET example
Hämta jobb information och hantera jobbGet job details and manage jobs Hantera jobb med v2Manage jobs with v2 Hantera jobb med v3Manage jobs with v3

Kända problemKnown issues

  • För närvarande kan du inte hantera v3-resurser med Azure-portalen.Currently, you cannot use the Azure portal to manage v3 resources. Använd REST API, CLI eller någon av de SDK: er som stöds.Use the REST API, CLI, or one of the supported SDKs.
  • Du måste etablera medie reserverade enheter (MRUs) i ditt konto för att kunna styra samtidigheten och prestandan för dina jobb, särskilt för video-eller ljud analys.You need to provision Media Reserved Units (MRUs) in your account in order to control the concurrency and performance of your Jobs, particularly ones involving Video or Audio Analysis. Mer information finns i Skala mediebearbetning.For more information, see Scaling Media Processing. Du kan hantera MRUs med CLI 2,0 för Media Services v3, med hjälp av Azure Portaleller v2-API: er.You can manage the MRUs using CLI 2.0 for Media Services v3, using the Azure portal, or using the v2 APIs. Du måste etablera MRUs, oavsett om du använder Media Services v2 eller v3-API: er.You need to provision MRUs, whether you are using Media Services v2 or v3 APIs.
  • Media Services entiteter som har skapats med v3-API: t kan inte hanteras av v2-API: et.Media Services entities created with the v3 API cannot be managed by the v2 API.
  • Vi rekommenderar inte att du hanterar entiteter som har skapats med v2-API: er via v3-API: erna.It is not recommended to manage entities that were created with v2 APIs via the v3 APIs. Följande är exempel på skillnader som gör att entiteterna i två versioner inte är kompatibla:Following are examples of the differences that make the entities in two versions incompatible:
    • Jobb och uppgifter som skapas i v2 visas inte i v3 eftersom de inte är associerade med en transformering.Jobs and Tasks created in v2 do not show up in v3 as they are not associated with a Transform. Rekommendationen är att växla till v3-transformeringar och-jobb.The recommendation is to switch to v3 Transforms and Jobs. Det kommer att finnas en relativt kort tids period för att övervaka synlighetssekvensnummer v2-jobben under växlingen.There will be a relatively short time period of needing to monitor the inflight v2 Jobs during the switchover.
    • Kanaler och program som skapats med v2 (som mappas till Live-händelser och Live-utdata i v3) kan inte fortsätta hanteras med v3.Channels and Programs created with v2 (which are mapped to Live Events and Live Outputs in v3) cannot continue being managed with v3. Rekommendationen är att byta till v3 Live-händelser och direktsända utdata i ett bekvämt kanal avbrott.The recommendation is to switch to v3 Live Events and Live Outputs at a convenient Channel stop.
      För närvarande kan du inte migrera kanaler som körs kontinuerligt.Presently, you cannot migrate continuously running Channels.

Anteckning

Den här sidan kommer att behållas när Media Servicess teamet gör fortsatta förbättringar av v3-API: erna och åtgärdar luckorna mellan versionerna.This page will be maintained as the Media Services team makes continued improvements to the v3 APIs and addresses the gaps between the versions.

Ställ frågor, ge feedback, hämta uppdateringarAsk questions, give feedback, get updates

Kolla in Azure Media Services community -artikeln för att se olika sätt att ställa frågor, lämna feedback och få uppdateringar om Media Services.Check out the Azure Media Services community article to see different ways you can ask questions, give feedback, and get updates about Media Services.

Nästa stegNext steps

Om du vill se hur lätt det är att börja koda och strömma videofiler, kolla in Strömma filer.To see how easy it is to start encoding and streaming video files, check out Stream files.