Usage

-- Lingo syntax
dvdObjRef.play()
dvdObjRef.play(beginTitle, beginChapter, endTitle, endChapter)
dvdObjRef.play(beginTimeList, endTimeList)

// JavaScript syntax
dvdObjRef.play();
dvdObjRef.play(beginTitle, beginChapter, endTitle, endChapter);
dvdObjRef.play(beginTimeList, beginTimeList);

Description

DVD method; starts or resumes playback.

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)

These statements start playing 10 seconds into chapter 2 and finish playing at 17 seconds:

member(15).play([#title:2, #seconds:10], [#title:2, #seconds:17])

See also

DVD, startTimeList, stopTimeList