Using the API
2
Vision
2
API Guide
Next, you must obtain a list of live channels which the Amino can play by using the
v2Master_GetLiveChannelList
command. For example:
http://<server>/v2services/v2_API/v2_APIUserService.asmx/v2Master_GetLiveChannelList
?sWantWMV=false&sWantMPEG2=true&sWantH264=true
This command returns XML code similar to the following:
<?xml version="1.0" encoding="utf-8" ?>
<v2>
<result>OK</result>
<livechannels>
<channel
type="v2DVB"
id="9018:16384:17024"
name="BBC Parliament"
address="234.1.0.2"
port="5500"
url="videocastmcast://234.1.0.2:5500/BBC Parliament"
level="0"
unmanaged="no"
/>
<channel
type="v2DVB"
id="9018:16384:17023"
name="BBC One"
address="234.1.0.3"
port="5500"
url="videocastmcast://234.1.0.3:5500/BBC One"
level="0"
unmanaged="no"
/>
</livechannels>
<secure>true</secure>
</v2>
From this code, all you need to extract is the name attribute to provide a means of selecting the desired
channel:
"BBC Parliament"
"BBC One"
For illustration purposes, assume the user selects "Main Reception" set-top box and the "BBC One" channel.
The user must then to make the change call to the
v2Master_STB_Amino_SetLiveChannel
command. For
example:
http://<server>/v2services/v2_API/v2_APIAdminService.asmx/v2Master_STB_Amino_SetLiveChannel
?sSTBIPAddress=43.192.168.110&sChannelIndex =1
Forcing a Specific Set-Top Box to Play a Specific Video
Obtain a list of the available set-top boxes as described in the
Forcing a Set-Top Box to Play a Specific Live
Channel
section on page 1. Next, you need to provide functionality to enable the user to choose the video to
play. See the
Vision2 RenderThumbs Explorer
section on page 37 for information on how to create a user
interface to play a video.
When the user has selected the video to play, you must then use to the
v2Master_STB_Amino_PlayVideo
command to start playback. For example:
http://server/v2services/v2_API/v2_APIAdminService.asmx/ v2Master_STB_Amino_PlayVideo
?sSTBIPAddress=43.192.168.110&sArchiveID=201101020304&sVideoID=150002
