Create or update a policy

General instructions on this operation can be found in the Akamai Cloud Embed API v2 documentation. (See Create or update a policy.)

Define the appropriate match criteria in the delivery policy

Like all other rules in a delivery policy, you must set a match criteria (matches) that must be met to apply the associated behaviors. In the example presented here, the url-wildcard match is used. This match compares the incoming request path (excluding query string) to what is defined as the value for the match "/*" is set here, which indicates all incoming request paths.

Include the "content-characteristics" behavior in the policy

To set up this support, you need to include the content-characteristics behavior, and the following members must be included:

• type: This must be set to streaming-video-live.
• value: This must be included and always be set to a hyphen (-).

With just these members set, live video is enabled for the subcustomer, using default settings. Additional specifics on the use of this behavior in a policy can be found in the ACE API v2 documentation.

You can set optional parameters

You have access to additional parameters ("params") with the content-characteristics behavior, when configuring support for live streaming video. They allow you to define specific settings for this subcustomer.

If you apply a segmentDuration<media format> parameter, what you set overrides the Akamai default duration values for this specific subcustomer.

* Individual members are included in this object to define the segment prefetch method to use. Each member is boolean and defaults to “false.”

JSON Examples

• Example 1: This example omits all of the optional parameters. (The params object is included, but left empty.) Default segment/fragment durations for all supported media formats will be used.

  {
      "rules":[
          {  
              "matches": [
                  {
                      "name": "url-wildcard",
                      "value": "/*"
                  }
              ],
              "behaviors": [
                  {
                      "name": "content-characteristics",
                      "type": "streaming-video-live",
                      "value": "-",
                      "params": {}
                  }
              ]
          }
      ]
  }

• Example 2: This example shows how to include live video streaming. It also shows how to set custom segment/fragment durations for a subcustomer, and also enable prefetching.

  {
      "rules":[
          {  
              "matches": [
                  {
                      "name": "url-wildcard",
                      "value": "/*"
                  }
              ],
              "behaviors": [
                  {
                      "name": "content-characteristics",
                      "type": "streaming-video-live",
                      "value": "-",
                      "params": {
                          "segmentDurationHLS": 6,
                          "segmentDurationHDS": 5.5,
                          "segmentDurationDASH": 2.5,
                          "segmentDurationSmooth": 2.5,
                          "overrideDefaultManifestTTL": true,
                          "prefetch": {
                              "originAssist": true
                          }
                      }
                  }
              ]
          }
      ]
  }