Reflector Parameters

The reflector is accessed through a password protected HTTP GET call, and can have multiple parameters.

• VOD
  • Video
  • Service
  • IP
  • XML
  • Videoname (only with service=download)
  • DIVX (only with service=download)
  • Multi Audio
  • Primary Audio
  • Subtitles
    • Example
  • Collections
    • Example
  • Base URL
    • Video parameter
    • Service parameter
• Live Stream
  • Video
  • Service
  • Play Offset & Play Duration
  • IP
  • XML
    • Example
    • Base URL
    • Video parameter
    • Service parameter

VOD

Base URL: http://dorcel.reflector.streaming.in2ip.nl/

Video

Parameter:

video

This parameter defines what video is to be served and contains both the folder name, and a filename. This can be either the ‘real’ filename, or a ‘special’ name like video.smil (pre-defined bitrate combinations). In the current release, the special names are:

• video.smil (250, 500, 800, 1500, 2500 Kbps)
• video1.smil (250, 500, 800 Kbps)
• video2.smil (500, 800, 1500, 2500, 4000 Kbps)
• video3.smil (250, 500, 800, 1500 Kbps)

Service

Parameter:

service

This parameter defines what exactly is returned and can have the following values:

• apple / m3u8
  This returns an URL to a HLS (apple compatible) m3u8 playlist
• dash
  This returns an URL to a DASH manifest (mpd)
• jwplayer / jwrss
  This returns an URL to a RSS (JWplayer 5 compatible) playlist
• token
  This returns an unique token that can be used to do ‘flexible embedding’ (see later in this document)
• download
  This returns an URL to a unique download URL where a single file can be downloaded. Please note: this only works with exact filenames and the parameter videoname must be set!

IP

Parameter:

ip

Please specify the IP of the requesting client (‘customer’) in this field, for tracking and security purposes (example: ip=1.2.3.4)

XML

Parameter:

xml

Defines if the result should be ‘plain’ (default) or XML (xml=true)

Videoname (only with service=download)

Parameter:

videoname

Defines the ‘friendly’ name a user sees as the filename when downloading a video. .mp4 is automagically added, unless the divx=true parameter is set.

DIVX (only with service=download)

Parameter:

divx

If this parameter is set to true, the extension ‘.divx’ is added to the downloadable file instead of ‘.mp4’.

Multi Audio

Parameter:

multi_audio

The argument(s) for this parameter can be either 1 for all available audio tracks, or a list with the correct 3 letter ISO code, separated by | (pipe symbol). You can add “orig” to the list if you want the original audio of the movie file to be included in the playout.

Examples:

multi_audio=1

All languages that are found are included.

multi_audio=eng|nld|orig

This will have English, Dutch and the original language included.

multi_audio=deu

This will play the original file with German audio.

Primary Audio

Parameter:

audio_pri

This parameter takes 1 argument, a 3 letter ISO code.

Subtitles

Parameter:

subs

The argument(s) for this parameter can either be 1 for all available subtitles, or a list with the correct 3 letter ISO code, separated by | (pipe symbol).

Examples:

subs=1

All languages that are found are included.

subs=eng|por

This will have English and Portiguese included.

Example

Full URL

http://dorcel.reflector.streaming.in2ip.nl/?video=99997/video2.smil&service=m3u8&multi_audio=1&subs=1

Collections

Parameter:

collection

The argument for this parameter is a string (case sensitive).

Collections allow loading video files from a different directory than the default directory. This can come in handy when organizing files in a certain structure.

Example:

collection=mycollection

Tokens for videos from the specified collection can now be obtained.

Example

Full URL

http://dorcel.reflector.streaming.in2ip.nl/?video=99997/video2.smil&service=m3u8&multi_audio=1&subs=1&collection=mycollection

Base URL

http://dorcel.reflector.streaming.in2ip.nl

This is the base URL that we’re using.

Video parameter

?video=99997/video2.smil

The video parameter specifies what piece of content we’re going to stream, this is an example for a VOD item. 99997 is the internal ID for the movie that we’re going to stream, behind that we’re specifying the aforementioned smil, different smils can give different bitrates that can be streamed.

Service parameter

&service=m3u8&multi_audio=1&subs=1

Here we specify that we want an HLS stream, that multi audio needs to be enabled and that we want subtitles for this movie.

Live Stream

Base URL: http://dorcel.reflector.streaming.in2ip.nl/

Video

Parameter:

video

This parameter defines what live stream is to be served. It consists of the name of the live stream and the specific stream you want for that live stream. Usually the name of the stream consists of two parts, “live_” and a language code. Different streams are usually used for multiple languages. The supported languages are:

• English (eng)
• French (fre/fra)
• Dutch (nld)
• German (deu)
• Polish (pol)
• Spanish (spa)
• Italian (ita)

NOTE: Not all live streams support all languages! Please ask for more information about what languages are supported for the stream you’re trying to use.

Example: dorceltv/live_fre.smil

Service

Parameter:

service

This parameter defines what exactly is returned and can have the following values:

• apple / m3u8
  This returns an URL to a HLS (apple compatible) m3u8 playlist
• dash
  This returns an URL to a DASH manifest (mpd)
• jwplayer / jwrss
  This returns an URL to a RSS (JWplayer 5 compatible) playlist
• token
  This returns an unique token that can be used to do ‘flexible embedding’ (see later in this document)

Play Offset & Play Duration

Parameters:

play_offset

or

play_duration

You can create a custom ‘segment’ of video by defining a start offset (play_offset, in seconds) and a duration (play_duration, in seconds). This can be used to create a ‘teaser’ after which one gets a payment option (see ‘flexible embedding’ later in this document) or to create multiple ‘virtual’ videos of a movie which is cut into different ‘submovies’ (by scene for example).

IP

Parameter:

ip

Please specify the IP of the requesting client (‘customer’) in this field, for tracking and security purposes (example: ip=1.2.3.4)

XML

Parameter:

xml

Defines if the result should be ‘plain’ (default) or XML (xml=true)

Example

Full URL:

http://dorcel.reflector.streaming.in2ip.nl/?video=dorceltv/live_eng.smil&service=m3u8

Base URL

http://dorcel.reflector.streaming.in2ip.nl

This is the base URL that we’re using.

Video parameter

?video=dorceltv/live_eng.smil

The video parameter specifies what we’re exactly going to stream, in this example we’re going to stream a live stream. Dorceltv is the service/channel that we’re going to stream, behind that we’re specifiying the smil or specific stream for this service that we want. In this case we’re going to stream the English variant.

Service parameter

&service=m3u8

Finally we specify that we want an HLS stream.

Returns:

• In non-XML mode:
  • Either the URL to the requested service, or the token
• In XML mode:

  • Same as in non-XML mode, but in XML formatting:

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="ServiceResponse.xsd">
    <resultCode>0</resultCode>
    <resultDescription>OK</resultDescription>
    <url>http://frontend-dev.streaming.in2ip.nl/smil/smil/eVcssfvnE5y0YeaNuRI3GvgAxUjnRBmA.smil</url> 
    </ServiceResponse>