BrightSign HD2000 Object Reference Manual User Manual

Page 17

Advertising
background image

Only a single file can be sent to an output at any given time. For example, two roAudioPlayers cannot
simultaneously play to the SPDIF output - the second one to attempt a PlayFile will get an error. To free an
output, the audio or video stream must be stopped (using ifMediaTransport’s Stop or StopClear calls).

Notes on this functionality:

 SPDIF and HDMI are the same audio output.

 Currently only a single set of USB speakers is supported.

 Only similar files may be played out of analog outputs simultaneously (meaning that it is not possible

to play a WAV file out of one analog output while simultaneously playing an MP3 file out of another
analog output).

 If the audio for a playing video is connected to one of the analog outputs, any remaining analog

outputs cannot be used by other sources. That is, the remaining analog outputs cannot be used for MP3
or WAV file playback.

 Each audio and video stream played consumes some of the finite CPU resources. The amount

consumed depends on the bitrates of the streams. Testing is the only way to really tell whether a given
set of audio files can be played at the same time as a video


Example: This code plays a video with audio over SPDIF/HDMI and an mp3 file to an analog port:
video=CreateObject("roVideoPlayer")
video.SetAudioMode(0)
video.SetAudioOutput(3)
video.PlayFile("video.mpg")

audio=CreateObject("roAudioPlayer")
audio.SetAudioOutput(0)
audio.MapStereoOutput(2)
audio.PlayFile("audio.mp3")

Playing Video Files with Multiple Audio Streams (HD2000 only)

MPEG-2 program streams can optionally contain a number of audio streams. These can all be the same or
different formats. Generally this is used either to provide alternative audio formats, or alternative
mixes/languages.

The HD2000 supports the playback of two audio streams from within a single program stream. The two
audio streams may be played back simultaneously (subject to the limitations documented above for playing
back multiple audio files simultaneously), or a specific audio stream from within a program stream can be
selected to support multiple languages / mixes.

The following functions control the auxiliary stream:

 SetAudioOutputAux (audio_output)

 SetAudioModeAux (audio_mode)

 MapStereoOutputAux (mapping)

 SetVolumeAux (volume)

 SetChannelVolumesAux (channel_mask, volume)

The following functions control which specific streams are played
 SetAudioStream (stream_index)

 SetAudioStreamAux (stream_index)
The stream_index is the index of the audio stream within the program stream to be played. A value of -1
indicates that the first audio stream found within the multiplex will be played.

Example: This code plays a video with the main audio stream over SPDIF/HDMI and the auxiliary
stream to an analog port:
video=CreateObject("roVideoPlayer")

17

Advertising
This manual is related to the following products: