Media Player Object - Get Property

Stores a selected property of a Media Player Object in a specific variable.

Use this action to get information about the current state of a Media Player Object.

Action ID:
Action Category:
Action List Syntax:

97
Media Player Object
<<VARIABLE>>
= MediaPlayerObject[<<OBJECTNAME>>].GetProperty (<<PROPERTY>>)

Settings

Variable:

The variable that the property will be stored in.

Object name:

The name of the Media Player Object whose properties will be queried.

Property

The property that will be stored in the variable. Choose from:

File Name

-

The full path to the media file currently associated with the Media Player Object.

Open State

-

The open state of the Media Player Object. Possible states are:
"Closed" - Content file is closed.
"Loading ASK" - Loading a Windows Media metafile.*
"Loading NSC" - Loading an .nsc file.*
"Locating" - Locating the server.
"Connecting" - Connecting to the server.
"Opening" - Opening or listening for the stream.
"Open" - Content file is open.

Play State

-

The play state or the Media Player Object. Possible states are:
"Stopped" -  Playback is stopped.
"Paused" - Playback is paused.
"Playing" - Stream is playing.
"Waiting" - Waiting for stream to begin.
"Scan Forward" - Stream is scanning forward.
"Scan Reverse" - Stream is scanning in reverse.
"Skip Forward" - Skipping to next.*
"Skip Reverse" - Skipping to previous.*
"Closed" - Stream is not open.

* These  properties are not available when the user has Media Player 9.0 installed.

NOTE

 

 

 

There may be slight differences between the open and play states returned in different situations by the version 9.0 and version 6.4 Windows Media Player ActiveX controls. Unless you're sure that your users are all using one version or the other, be sure to test your project with both versions to make sure it will work for all users.

For more information on the two versions, see Media Player 9.0 Compatibility Issues.

Error Codes

Value
(%LastErrorNum%)

Simple Message
(%LastErrorMsg%)

Verbose Message
(%LastErrorDetails%)

0 (OK)

 

 

1

MSG_ERR_MEDIA_PLAYER_OBJECT_GET_PROPERTY

MSG_ERR_MEDIA_PLAYER_OBJECT_GET_PROPERTY
MSG_ERR_OBJECT_NOT_FOUND
<<OBJECTNAME>>

Examples

None