Media Services v3 widevine licencsablon áttekintése
Az Azure Media Services lehetővé teszi a tartalom titkosítását a Google Widevine használatával. A Media Services a Widevine-licencek kézbesítésére is kínál szolgáltatást. Az Azure Media Services API-kkal konfigurálhatja a Widevine-licenceket. Amikor egy játékos megpróbálja lejátszani a Widevine által védett tartalmat, a rendszer kérést küld a licenckézbesítési szolgáltatásnak a licenc beszerzésére. Ha a licencszolgáltatás jóváhagyja a kérést, a szolgáltatás kiadja a licencet. A rendszer elküldi az ügyfélnek, és a megadott tartalom visszafejtésére és lejátszására szolgál.
Megjegyzés
A Widevine nem érhető el a GovCloud régióban.
A Widevine-licenckérelem JSON-üzenetként van formázva.
{
"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>
}
}
Megjegyzés
Létrehozhat egy üres üzenetet érték nélkül, csak "{}". Ezután létrejön egy licencsablon az alapértelmezett értékekkel. Az alapértelmezett beállítás a legtöbb esetben működik. A Microsoft-alapú licenckézbesítési forgatókönyveknek mindig az alapértelmezett értékeket kell használniuk. Ha be kell állítania a "szolgáltató" és a "content_id" értéket, a szolgáltatónak meg kell egyeznie a Widevine hitelesítő adataival.
JSON-üzenet
| Name | Érték | Leírás |
|---|---|---|
| payload | Base64 kódolású sztring | Az ügyfél által küldött licenckérelem. |
| content_id | Base64 kódolású sztring | Az egyes content_key_specs.track_type kulcsazonosítójának és tartalomkulcsának származtatásához használt azonosító. |
| Szolgáltató | sztring | Tartalomkulcsok és szabályzatok keresésére szolgál. Ha a Widevine-licenc kézbesítéséhez Microsoft-kulcskézbesítést használ, a rendszer figyelmen kívül hagyja ezt a paramétert. |
| policy_name | sztring | Egy korábban regisztrált szabályzat neve. Választható. |
| allowed_track_types | Enum | SD_ONLY vagy SD_HD. Szabályozza, hogy mely tartalomkulcsok szerepelnek a licencben. |
| content_key_specs | A JSON-struktúrák tömbje, lásd a "Tartalomkulcs-specifikációk" című szakaszt. | Finomított vezérlőelem, amelyre a tartalomkulcsokat vissza kell adni. További információt a "Tartalomkulcs-specifikációk" című szakaszban talál. Csak az egyik allowed_track_types és content_key_specs érték adható meg. |
| use_policy_overrides_exclusively | Logikai, igaz vagy hamis | Használjon policy_overrides által megadott szabályzatattribútumokat, és hagyja ki az összes korábban tárolt szabályzatot. |
| policy_overrides | JSON-struktúra, lásd a "Szabályzat felülbírálása" című szakaszt. | A licenc szabályzatbeállításai. Abban az esetben, ha ez az objektum előre definiált szabályzattal rendelkezik, a rendszer ezeket a megadott értékeket használja. |
| session_init | JSON-struktúra, lásd a "Munkamenet inicializálása" című szakaszt. | A nem kötelező adatok a licencnek lesznek átadva. |
| parse_only | Logikai, igaz vagy hamis | A licenckérelmet a szolgáltatás elemzi, de nem ad ki licencet. A rendszer azonban visszaadja a licenckérelem értékeit a válaszban. |
Tartalomkulcs-specifikációk
Ha létezik már meglévő szabályzat, nem kell megadnia a tartalomkulcs-specifikációban szereplő értékeket. A tartalomhoz társított, már meglévő szabályzattal határozható meg a kimeneti védelem, például a nagy sávszélességű digitális tartalomvédelem (HDCP) és a másolási általános felügyeleti rendszer (CGMS). Ha egy meglévő szabályzat nincs regisztrálva a Widevine licenckiszolgálón, a tartalomszolgáltató beszúrhatja az értékeket a licenckérelembe.
Minden content_key_specs értéket meg kell adni az összes sávhoz, a use_policy_overrides_exclusively beállítástól függetlenül.
| Name | Érték | Leírás |
|---|---|---|
| content_key_specs. track_type | sztring | Egy számtípus neve. Ha content_key_specs van megadva a licenckérelemben, mindenképpen explicit módon adja meg az összes követéstípust. Ha ezt nem teszi meg, az azt eredményezi, hogy az elmúlt 10 másodpercben nem játszható le. |
| content_key_specs security_level |
uint32 | Meghatározza az ügyfél robusztussági követelményeit a lejátszáshoz. – Szoftveralapú, fehér dobozos titkosításra van szükség. - Szoftveres titkosításra és rejtjelezett dekóderre van szükség. – A fő anyag- és titkosítási műveleteket hardveralapú megbízható végrehajtási környezetben kell végrehajtani. – A tartalom titkosítását és dekódolását hardveralapú megbízható végrehajtási környezetben kell elvégezni. - A titkosítást, a dekódolást és az adathordozók (tömörített és tömörítetlen) kezelését hardveralapú megbízható végrehajtási környezetben kell kezelni. |
| content_key_specs required_output_protection.hdc |
sztring, HDCP_NONE, HDCP_V1, HDCP_V2 | Azt jelzi, hogy szükség van-e a HDCP-re. |
| content_key_specs kulcs |
Base64- kódolt sztring |
Ehhez a számhoz használandó tartalomkulcs. Ha meg van adva, a track_type vagy a key_id kötelező megadni. A tartalomszolgáltató ezzel a beállítással injektálhatja a tartalomkulcsot ehhez a számhoz ahelyett, hogy a Widevine licenckiszolgáló létrehozhat vagy megkereshet egy kulcsot. |
| content_key_specs.key_id | Base64 kódolású bináris sztring, 16 bájt | A kulcs egyedi azonosítója. |
Szabályzat felülbírálása
| Name | Érték | Leírás |
|---|---|---|
| policy_overrides.can_play | Logikai, igaz vagy hamis | Azt jelzi, hogy a tartalom lejátszása engedélyezett. Az alapértelmezett érték a false (hamis). |
| policy_overrides.can_persist | Logikai, igaz vagy hamis | Azt jelzi, hogy a licenc megmaradhat a nem konvolatilis tárolóban offline használatra. Az alapértelmezett érték a false (hamis). |
| policy_overrides.can_renew | Logikai, igaz vagy hamis | Azt jelzi, hogy a licenc megújítása engedélyezett. Ha igaz, a licenc időtartama szívveréssel meghosszabbítható. Az alapértelmezett érték a false (hamis). |
| policy_overrides.license_duration_seconds | int64 | Az adott licenc időkeretét jelzi. A 0 érték azt jelzi, hogy nincs korlátozás az időtartamra. Az alapértelmezett érték a 0. |
| policy_overrides.rental_duration_seconds | int64 | Azt az időablakot jelzi, amíg a lejátszás engedélyezett. A 0 érték azt jelzi, hogy nincs korlátozás az időtartamra. Az alapértelmezett érték a 0. |
| policy_overrides.playback_duration_seconds | int64 | A lejátszás utáni megtekintési idő a licenc időtartamán belül kezdődik. A 0 érték azt jelzi, hogy nincs korlátozás az időtartamra. Az alapértelmezett érték a 0. |
| policy_overrides.renewal_server_url | sztring | A licenchez tartozó összes szívverési (megújítási) kérés a megadott URL-címre lesz irányítva. Ez a mező csak akkor használatos, ha can_renew igaz. |
| policy_overrides.renewal_delay_seconds | int64 | A megújítást license_start_time után hány másodperccel kíséreli meg először a rendszer. Ez a mező csak akkor használatos, ha can_renew igaz. Az alapértelmezett érték a 0. |
| policy_overrides.renewal_retry_interval_seconds | int64 | Megadja a következő licencmegújítási kérelmek közötti késleltetést másodpercben, hiba esetén. Ez a mező csak akkor használatos, ha can_renew igaz. |
| policy_overrides.renewal_recovery_duration_seconds | int64 | Az az időkeret, amelyben a rendszer a megújítási kísérlet során folytathatja a lejátszást, de a licenckiszolgáló háttérbeli problémái miatt sikertelen. A 0 érték azt jelzi, hogy nincs korlátozás az időtartamra. Ez a mező csak akkor használatos, ha can_renew igaz. |
| policy_overrides.renew_with_usage | Logikai, igaz vagy hamis | Azt jelzi, hogy a licenc megújításra lesz elküldve a használat kezdetekor. Ez a mező csak akkor használatos, ha can_renew igaz. |
Munkamenet inicializálása
| Name | Érték | Leírás |
|---|---|---|
| provider_session_token | Base64 kódolású sztring | Ez a munkamenet-jogkivonat visszakerül a licencbe, és a későbbi megújítások során is létezik. A munkamenet-jogkivonat nem marad meg a munkameneteken kívül. |
| provider_client_token | Base64 kódolású sztring | Ügyféljogkivonat a licencválaszba való visszaküldéshez. Ha a licenckérelem tartalmaz egy ügyféljogkivonatot, a rendszer figyelmen kívül hagyja ezt az értéket. Az ügyfél jogkivonata a licencelési munkameneteken túl is megmarad. |
| override_provider_client_token | Logikai, igaz vagy hamis | Ha hamis, és a licenckérelem tartalmaz egy ügyféljogkivonatot, akkor is használja a kérés jogkivonatát, ha ebben a struktúrában ügyféljogkivonat van megadva. Ha igaz, mindig az ebben a struktúrában megadott jogkivonatot használja. |
További megjegyzések
- A Widevine a Google Inc. által nyújtott szolgáltatás, amelyre a Google, Inc. szolgáltatási feltételei és adatvédelmi irányelvei vonatkoznak.
Súgó és támogatás
Kérdéseket tehet fel a Media Serviceshez, vagy kövesse a frissítéseket az alábbi módszerek egyikével:
- Q & A
- Stack Overflow. Kérdések címkézése a következővel:
azure-media-services. - @MSFTAzureMediavagy @AzureSupport használatával kérjen támogatást.
- Nyisson meg egy támogatási jegyet a Azure Portal keresztül.