<Multimedia>.Play (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Using the MultimediaPlay function
Android specific features

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Multimedia>.Play (Function)

In french: <Multimédia>.Joue

Plays a media file in a Multimedia control.

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

Example

MonFichier is string = "C:\Ma musique\mysong.mp3"
IF MM_Multimédia1.Joue(MonFichier) = False THEN
	Error("Erreur de lecture du fichier")
END

Syntax

<Result> = <Multimedia control>.Play([<Name of file to play> [, <Options>]])

<Result>: Boolean

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

<Multimedia control>: Control name

Name of Multimedia control used to play the media file.

<Name of 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.
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. 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

<Multimedia>.Play 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 <Multimedia>.Pause.
Note: To pause the playback of a media file, the media file must have been started via the MultimediaOpen function followed by the <Multimedia>.Play function, specifying only the field name..

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

Android specific features

By default, <Multimedia>.Play 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 (<Multimedia>.Position, ...) 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