Contact support
    • Serverside.ai
    • Video player and app

    Live: DASH and HLS

    Table of Contents

    Overview DASH live manifest Request Path parameters Query parameters Response (200) HLS live manifest Request Path parameters Query parameters Response (200) Ad-server parameter

    Overview 

    This document explains how to retrieve live streaming manifests for DASH and HLS from Serverside.ai. Each request requires a dedicated API key, and the manifests enable video playback and support SSAI dynamic ad insertion.

    DASH live manifest

    Request

    GET https://mydomain.com/dash/view/:channelId

    Retrieves the DASH live manifest URL for a given channel.

    Path parameters

    Field Type Description
    channelId string The ID of the channel in Serverside.ai.

    Query parameters

    Field Type Description
    api-key string The parameter obtained from the channel in Serverside.ai.

    Response (200)

    {
    "mediaURL": "https://mydomain.com/dash/d9f35993-542d-4cf4-b9fa-227b08bf3376/a0a5b9a0-6586-11ea-b321-45af751b3213.mpd",
    "vastURL": "https://mydomain.com/dash/d9f35993-542d-4cf4-b9fa-227b08bf3376/a0a5b9a0-6586-11ea-b321-45af751b3213/vast"
}
     
     

    The mediaURL from the response can be used to play back the asset in a video player.

    For more information about VAST tracking, see VAST tracking: VoD - DASH and HLS.

    HLS live manifest

    Request

    GET https://mydomain.com/hls/:channelId/master.m3u8

    Retrieves the HLS live manifest for a given channel.

    Path parameters

    Field Type Description
    channelId string The ID of the channel in Serverside.ai.

    Query parameters

    Field Type Description
    api-key string The parameter obtained from the channel in Serverside.ai.

    Response (200)

    #EXTM3U
#EXT-X-VERSION:4
#EXT-X-INDEPENDENT-SEGMENTS
#EXT-X-STREAM-INF:FRAME-RATE="25.000",RESOLUTION=320x180,CODECS="avc1.4d400c,mp4a.40.2",AVERAGE-BANDWIDTH="545600",BANDWIDTH=545600
634d44a0-6587-11ea-9401-b4d1dabb06a7/320x180.m3u8
#EXT-X-STREAM-INF:FRAME-RATE="25.000",RESOLUTION=480x272,CODECS="avc1.4d4015,mp4a.40.2",AVERAGE-BANDWIDTH="765600",BANDWIDTH=765600
634d44a0-6587-11ea-9401-b4d1dabb06a7/480x270.m3u8
#EXT-X-STREAM-INF:FRAME-RATE="25.000",RESOLUTION=640x360,CODECS="avc1.77.30,mp4a.40.2",AVERAGE-BANDWIDTH="1161600",BANDWIDTH=1161600
634d44a0-6587-11ea-9401-b4d1dabb06a7/640x360.m3u8
#EXT-X-STREAM-INF:FRAME-RATE="25.000",RESOLUTION=960x540,CODECS="avc1.4d401f,mp4a.40.2",AVERAGE-BANDWIDTH="2140600",BANDWIDTH=2140600
634d44a0-6587-11ea-9401-b4d1dabb06a7/960x540.m3u8
#EXT-X-STREAM-INF:FRAME-RATE="25.000",RESOLUTION=1280x720,CODECS="avc1.4d401f,mp4a.40.2",AVERAGE-BANDWIDTH="3339600",BANDWIDTH=3339600
634d44a0-6587-11ea-9401-b4d1dabb06a7/1280x720.m3u8
     
     

    Unlike DASH, the HLS response is already a manifest; no further requests are needed.

    For more information about VAST tracking, see VAST tracking: Live - HLS.

    Ad-server parameter

    Some deployments might require an additional query parameter to control the ad server.

    For more information about VAST tracking, see the articles under Ad server integration.

    RELATED ARTICLES