User Guide

play() (DVD) 449
Without parameters, this method resumes playback if paused, or, if stopped, starts playback at the
top of a disc or at the value specified by the
startTimeList property. Playback continues until
the value specified by the
stopTimeList property, if set.
With the
beginTitle, beginChapter, and endTitle, endChapter parameters, this method
starts playback at a given title, chapter. Playback continues until the specified
endTitle,
endChapter
parameters, if set.
With the
beginTimeList and endTimeList parameters, this method plays from the value
specified by the
beginTimeList parameter to the value specified by the endTimeList parameter.
The list formats used for
beginTimeList and endTimeList:
[#title:1, #chapter:1, #hours:0, #minutes:1, #seconds:1]
or
[#title:1, #hours:0, #minutes:1, #seconds:1]
This method returns 0 if successful.
Parameters
beginTitle
Required if starting playback at a given title and chapter. A number that specifies the
title that contains the chapter to play. This parameter will override the member's
startTimeList
property.
beginChapter Required if starting playback at a given title and chapter. A number that specifies
the chapter to play. This parameter will override the member's
startTimeList property.
endTitle Required if stopping playback at a given title and chapter. A number that specifies the
title where playback will stop. This parameter will override the member's
stopTimeList
property.
endChapter Required if stopping playback at a given title and chapter. A number that specifies
the chapter to play. This parameter will override the member's
stopTimeList property.
beginTimeList Required if starting playback at a given start time. A property list that specifies
the time at which playback starts. This parameter will override the member's
startTimeList
property.
endTimeList Required if starting playback at a given start time. A property list that specifies the
time at which playback stops. This parameter will override the member's
stopTimeList property.
Example
This statement resumes playback of a paused sprite:
-- Lingo syntax
member(12).play()
// JavaScript syntax
member(12).play();
These statements start playing at chapter 2 of title 1 and finish playing at chapter 4:
member(15).play([#title:1, #chapter:2], [#title:1, #chapter:4])
or
member(15).play(1,2,1,4)