適用於多個內容和廣告來源的 MediaTailor 網域變數 - AWS Elemental MediaTailor
建立組態別名以用作動態變數使用組態別名來動態設定工作階段的網域

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

適用於多個內容和廣告來源的 MediaTailor 網域變數

AWS Elemental MediaTailor 動態網域變數可讓您使用多個網域，例如 URL my-ads-server.com 的 http://my-ads-server.com 部分，以及組態中的玩家參數。這可讓您在單一組態中使用多個內容來源或廣告決策伺服器 (ADS)。

您可以使用網域變數搭配包含 URI 的任何參數：

  • AdDecisionServerUrl

  • AdSegmentUrlPrefix

  • ContentSegmentUrlPrefix

  • LivePreroll.AdDecisionServerUrl

  • VideoContentSourceUrl

網域變數會與組態別名搭配使用，以執行動態變數取代。組態別名會將一組別名和值對應至用於動態網域組態的玩家參數。

建立組態別名以用作動態變數

開始使用網域變數之前，您可以為組態建立組態別名。您可以在工作階段初始化時間使用組態別名做為網域取代變數。例如，您可以使用組態別名，在工作階段初始化期間動態設定原始伺服器 URL。

建立組態別名

若要使用 MediaTailor 主控台建立用於網域取代的組態別名，請執行下列程序。

使用主控台建立組態別名

  1. 在 https：//https://console.aws.amazon.com/mediatailor/ 開啟 MediaTailor 主控台。

  2. 在組態頁面上的組態別名區段中，選擇新增玩家參數。

  3. 輸入您要用作網域替換動態變數的玩家參數名稱。您必須在名稱前加上 player_params.。

  4. 選擇確定。

    AWS Elemental MediaTailor 會在組態別名區段的表格中顯示新參數。

  5. 現在，您將新增別名和值。選取您剛命名的玩家參數。這會展開參數名稱下方的 區段。

    選取新增別名。

  6. 輸入別名索引鍵和值。MediaTailor 使用 值做為網域變數的替代值。

使用組態別名來動態設定工作階段的網域

設定組態別名之後，您可以在工作階段初始化請求中將其用作網域的替代變數。這可讓您動態設定工作階段的網域。

限制

使用組態別名時，請注意下列限制：

  • 網域中使用的所有動態變數都必須定義為ConfigurationAliases動態變數。

  • 玩家參數變數必須以 為字首player_params.。例如 player_params.origin_domain。

  • 每個玩家參數的別名值清單必須詳盡。

  • 如果對網域中使用的動態值提出請求，且該請求未指定動態變數或該變數的其中一個預先設定別名，則請求會失敗，並顯示 HTTP 400 狀態碼。

範例 用量範例

以下是包含組態別名和動態網域變數的組態範例。請特別注意 AdDecisionServerUrl和 參數網域中的玩家VideoContentSourceUrl參數變數[player_params.origin_domain]，例如 。

PUT /playbackConfiguration
   {
       "Name": "aliasedConfig",
       ...
       "AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
       "VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
       ...
       "ConfigurationAliases": {
           "player_params.origin_domain": {
               "pdx": "abc",
               "iad": "xyz"
           },
           "player_params.region": {
               "pdx": "us-west-2",
               "iad": "us-east-1"
           },
           "player_params.endpoint_id": {
               "pdx": "abcd",
               "iad": "wxyz"
           },
           "player_params.ad_type": {
               "customized": "abc12345",
               "default": "defaultAdType"
           },
       },
       ...
   }

使用上述組態，建立工作階段初始化請求，並指定玩家變數和別名：

POST master.m3u8
   {
       "playerParams": {
           "origin_domain": "pdx",
           "region": "pdx",
           "endpoint_id": "pdx",
           "ad_type": "customized"
       }
   }

MediaTailor 會將別名字串取代為組態別名組態中的對應值。

對 ADS 的請求如下所示：

https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345

對 的請求VideoContentSource如下所示：

https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/abcd