MultimediaPlay (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Multimedia functions

Prefix syntax

MultimediaPlay

Presentation

Example

Using the MultimediaPlay function

Android specific features

See also

MultimediaPlay (Function)

In french: MultimédiaJoue

Plays a multimedia file in a Multimedia control.

Remark: Depending on the video type and on the browser configuration, this function may not be supported. In this case, its use will have no effect but no error will be triggered.

Example

MyFile is string = "C:\My music\mysong.mp3"
IF MultimediaPlay(MM_Multimedia1, MyFile) = False THEN
Error("Error while playing the file")
END

Syntax

<Result> = MultimediaPlay(<Multimedia control> [, <File to play> [, <Options>]])

<Result>: Boolean

True if the file was successfully played,
False otherwise. To get more details on the error, use ErrorInfo.
Remark: ErrorInfo is not available.

<Multimedia control>: Control name

Name of Multimedia control used to play the media file.

<File to play>: Optional character string

Name and path of the media file to play.
If this parameter is specified, the media file is loaded in memory and played. The media file is always played from the beginning.
If this parameter is not specified or if it corresponds to an empty string (""), the file associated with the control (by MultimediaOpen for example) is automatically used.
This parameter is not available. The file associated with the control is automatically used.
Corresponds to:
the name and path of media file to play.
a URL (to play the video in streaming).
a resource name (file name + extension) added to the application via the generation wizard.
Corresponds to:
the name and path of media file to play.
a video URL on a server. Remark: the YouTube videos cannot be played.
a resource name (file name + extension) added to the application via the generation wizard.

<Options>: Integer constant

Option for reading the file:
MultimediaNonBlocking The loading of the multimedia file is a non-locking operation.

Remarks

Using the MultimediaPlay function

MultimediaPlay can be used:

to load a multimedia file in memory and to play this file.
to play a media file loaded by MultimediaOpen.
to restart a file paused by MultimediaPause.
Remark: To pause the playback of a media file, it must have been started via MultimediaOpen followed by MultimediaPlay, specifying only the name of the control.

Several Multimedia controls can be created in the same window. However, multiple videos cannot be played simultaneously with MultimediaPlay.

Android specific features

By default, MultimediaPlay is a blocking function until the control is ready to play the file.
The MultimediaNonBlocking constant is used to perform a non-locking load operation. In this case, the call to a Multimedia function (MultimediaPosition, ...) will fail as long as the media file is not loaded by the control.
The non-locking load operations are recommended when using media files not found on the device (online video for example).
If <File to play> is the URL of a video on a "https" web server, the "android.permission.INTERNET" permission must be added in the application generation wizard.
In Android, all the formats supported by the OS can be played (wav, mp3, 3gp, ogg, ...). A summary of the supported audio and video files is available from the following address: http://developer.android.com/guide/appendix/media-formats.html. Remark: Android does not support 32-bit wav files.

Component: wd270obj.dll