MultimediaPlay (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Multimedia functions

Using the MultimediaPlay function
Android specific features

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MultimediaPlay (Function)

In french: MultimédiaJoue

Not available

Plays a media file in a Multimedia control.

Example

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.

<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 is an empty string (""), the file associated with the control (by MultimediaOpen for example) 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. Note: 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 media file is a non-locking operation.

Remarks

Using the MultimediaPlay function

MultimediaPlay can be used:

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

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. Note: 32-bit wav files are not supported by Android..

Component: wd300obj.dll