Översikt över Widevine-licensmallenWidevine license template overview

• 3/10/2021
• 6 minuter för att läsa
• • I
  • o
  • i

Du kan använda Azure Media Services för att konfigurera och begära Google Widevine-licenser.You can use Azure Media Services to configure and request Google Widevine licenses. När spelaren försöker spela upp det Widevine innehållet skickas en begäran till licens leverans tjänsten för att få en licens.When the player tries to play your Widevine-protected content, a request is sent to the license delivery service to obtain a license. Om licens tjänsten godkänner begäran utfärdar tjänsten licensen.If the license service approves the request, the service issues the license. Den skickas till klienten och används för att dekryptera och spela upp det angivna innehållet.It's sent to the client and is used to decrypt and play the specified content.

En begäran om Widevine-licens formateras som ett JSON-meddelande.A Widevine license request is formatted as a JSON message.

{  
   "payload": "<license challenge>",
   "content_id": "<content id>" 
   "provider": "<provider>"
   "allowed_track_types": "<types>",
   "content_key_specs": [  
      {  
         "track_type": "<track type 1>"
      },
      {  
         "track_type": "<track type 2>"
      },
      …
   ],
   "policy_overrides": {  
      "can_play": <can play>,
      "can persist": <can persist>,
      "can_renew": <can renew>,
      "rental_duration_seconds": <rental duration>,
      "playback_duration_seconds": <playback duration>,
      "license_duration_seconds": <license duration>,
      "renewal_recovery_duration_seconds": <renewal recovery duration>,
      "renewal_server_url": "<renewal server url>",
      "renewal_delay_seconds": <renewal delay>,
      "renewal_retry_interval_seconds": <renewal retry interval>,
      "renew_with_usage": <renew with usage>
   }
}

JSON-meddelandeJSON message

Specifikationer för innehålls nyckelContent key specs

Om det finns en befintlig princip behöver du inte ange något av värdena i innehålls nyckel specifikationen. Den befintliga principen som är associerad med det här innehållet används för att fastställa utmatnings skyddet, t. ex. digitala Content Protection med hög bandbredd (HDCP) och det kopierade hanterings systemet (CGMS).If a preexisting policy exists, there is no need to specify any of the values in the content key spec. The preexisting policy associated with this content is used to determine the output protection, such as High-bandwidth Digital Content Protection (HDCP) and the Copy General Management System (CGMS). Om en befintlig princip inte är registrerad på Widevine-licensserver, kan innehålls leverantören mata in värdena i licens förfrågan.If a preexisting policy isn't registered with the Widevine license server, the content provider can inject the values into the license request.

Varje content_key_specs värde måste anges för alla spår, oavsett alternativet use_policy_overrides_exclusively.Each content_key_specs value must be specified for all tracks, regardless of the use_policy_overrides_exclusively option.

Princip åsidosättningarPolicy overrides

Initiering av sessionSession initialization

Konfigurera dina Widevine-licenser med hjälp av .NET-typerConfigure your Widevine licenses by using .NET types

Media Services tillhandahåller .NET-API: er som du kan använda för att konfigurera dina Widevine-licenser.Media Services provides .NET APIs that you can use to configure your Widevine licenses.

Klasser som definieras i Media Services .NET SDKClasses as defined in the Media Services .NET SDK

Följande klasser är definitioner av dessa typer:The following classes are the definitions of these types:

public class WidevineMessage
{
    public WidevineMessage();

    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
    public AllowedTrackTypes? allowed_track_types { get; set; }
    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
    public ContentKeySpecs[] content_key_specs { get; set; }
    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
    public object policy_overrides { get; set; }
}

[JsonConverter(typeof(StringEnumConverter))]
public enum AllowedTrackTypes
{
    SD_ONLY = 0,
    SD_HD = 1
}
public class ContentKeySpecs
{
    public ContentKeySpecs();

    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
    public string key_id { get; set; }
    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
    public RequiredOutputProtection required_output_protection { get; set; }
    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
    public int? security_level { get; set; }
    [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
    public string track_type { get; set; }
}

public class RequiredOutputProtection
{
    public RequiredOutputProtection();

    public Hdcp hdcp { get; set; }
}

[JsonConverter(typeof(StringEnumConverter))]
public enum Hdcp
{
    HDCP_NONE = 0,
    HDCP_V1 = 1,
    HDCP_V2 = 2
}

ExempelExample

I följande exempel visas hur du använder .NET-API: er för att konfigurera en enkel Widevine-licens:The following example shows how to use .NET APIs to configure a simple Widevine license:

private static string ConfigureWidevineLicenseTemplate()
{
    var template = new WidevineMessage
    {
        allowed_track_types = AllowedTrackTypes.SD_HD,
        content_key_specs = new[]
        {
            new ContentKeySpecs
            {
                required_output_protection = new RequiredOutputProtection { hdcp = Hdcp.HDCP_NONE},
                security_level = 1,
                track_type = "SD"
            }
        },
        policy_overrides = new
        {
            can_play = true,
            can_persist = true,
            can_renew = false
        }
    };

    string configuration = JsonConvert.SerializeObject(template);
    return configuration;
}

Ytterligare informationAdditional notes

• Widevine är en tjänst som tillhandahålls av Google Inc. och omfattas av villkoren i tjänste-och sekretess policyn för Google, Inc.Widevine is a service provided by Google Inc. and subject to the terms of service and Privacy Policy of Google, Inc.

Sökvägar för Media Services-utbildningMedia Services learning paths

Media Services v3 (senaste)Media Services v3 (latest)

Kolla in den senaste versionen av Azure Media Services!Check out the latest version of Azure Media Services!

• ÖversiktOverview
• BegreppConcepts
• Börja utvecklaStart developing
• Vägledning för migrering från v2 till v3Migration guidance from v2 to v3

Media Services v2 (äldre)Media Services v2 (legacy)

• ÖversiktOverview
• Skapa kontoCreate account
• Leverera på begäranDeliver on-demand
• Leverera LiveDeliver live

Ge feedbackProvide feedback

Använd User Voice-forumet för att ge feedback och förslag på hur Azure Media Services kan förbättras.Use the User Voice forum to provide feedback and make suggestions on how to improve Azure Media Services. Du kan även gå direkt till någon av följande kategorier:You also can go directly to one of the following categories:

• Azure Media PlayerAzure Media Player
• SDK-klientbibliotekClient SDK libraries
• Kodning och bearbetningEncoding and processing
• LiveuppspelningLive streaming
• MedieanalysMedia Analytics
• Azure-portalenAzure portal
• REST-API och plattformREST API and platform
• Videoströmning på begäranVideo-on-demand streaming

Se ävenSee also

Använda PlayReady och/eller Widevine Dynamic Common EncryptionUse PlayReady and/or Widevine dynamic common encryption