<Multimedia>.Play (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Using the MultimediaPlay function
Specific features for Android

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Multimedia>.Play (Function)

In french: <Multimédia>.Joue

Plays a multimedia file in a Multimedia control.

Versions 15 and later

This function is now available in Browser code.

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.

New in version 15

This function is now available in Browser code.

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.

This function is now available in Browser code.

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.

Versions 17 and later

This function is now available for Android applications.

New in version 17

This function is now available for Android applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

MyFile is string = "C:\My music\mysong.mp3"
// For Windows Mobile:
// MyFile is string = "\My Documents\My music\mysong.mp3"
IF MM_Multimedia1.Play(MyFile) = False THEN
Error("Error while playing the file")
END

Syntax

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

<Result>: Boolean

True if the file was successfully played,
False otherwise. For more details about the error, use the ErrorInfo function.
Remark: ErrorInfo is not available.

<Multimedia control>: Control name

Name of Multimedia control used to play the multimedia file.

<Name of file to play>: Optional character string

Name and path of the multimedia file to play.
If this parameter is specified, the multimedia file is loaded in memory and played. The multimedia 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.
Versions 15 and later
This parameter is not available. The file associated with the control is automatically used.
New in version 15
This parameter is not available. The file associated with the control is automatically used.
This parameter is not available. The file associated with the control is automatically used.
Versions 17 and later
Corresponds to:
the name and path of multimedia 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.
New in version 17
Corresponds to:
the name and path of multimedia 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 multimedia 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.
Versions 18 and later
Corresponds to:
the name and path of multimedia 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.
New in version 18
Corresponds to:
the name and path of multimedia 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.
Corresponds to:
the name and path of multimedia 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

Versions 17 and later
Option for reading the file:
MultimediaNonBlocking The loading of the multimedia file is a non-locking operation.
New in version 17
Option for reading the file:
MultimediaNonBlocking The loading of the multimedia file is a non-locking operation.
Option for reading the file:
MultimediaNonBlocking The loading of the multimedia file is a non-locking operation.

Remarks

Using the MultimediaPlay function

<Multimedia>.Play can be used:

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

Versions 18 and later

Several Multimedia controls can be created in the same window. However, several videos cannot be played in parallel by <Multimedia>.Play.

New in version 18

Several Multimedia controls can be created in the same window. However, several videos cannot be played in parallel by <Multimedia>.Play.

Versions 17 and later

Specific features for Android

By default, <Multimedia>.Play is a locking 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 multimedia file is not loaded by the control.
The non-locking load operations are recommended when using multimedia files not found on the device (online video for example).
If the <File to play> parameter matches the URL of a video present on an "https" web server, it is necessary to add the Permission "android.Permission.INTERNET" in the wizard of generating the application.
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: the wav files in 32-bit format are not supported by Android.

New in version 17

Specific features for Android

By default, <Multimedia>.Play is a locking 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 multimedia file is not loaded by the control.
The non-locking load operations are recommended when using multimedia files not found on the device (online video for example).
If the <File to play> parameter matches the URL of a video present on an "https" web server, it is necessary to add the Permission "android.Permission.INTERNET" in the wizard of generating the application.
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: the wav files in 32-bit format are not supported by Android.

Specific features for Android

By default, <Multimedia>.Play is a locking 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 multimedia file is not loaded by the control.
The non-locking load operations are recommended when using multimedia files not found on the device (online video for example).
If the <File to play> parameter matches the URL of a video present on an "https" web server, it is necessary to add the Permission "android.Permission.INTERNET" in the wizard of generating the application.
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: the wav files in 32-bit format are not supported by Android.

Component: wd260obj.dll