Command Reference - Media Player Object Actions
Seeks to (i.e. goes directly to) a specific time in a Media Player Object.
|
Action ID: |
50 |
The name of the Media Player Object that you want to perform the seek in.
The position to seek to. Choose from:
|
Beginning |
- |
Go to the beginning of the media (e.g. movie, mp3, wav). |
|
End |
- |
Go to the end of the media. |
|
Specific time |
- |
Go to the time specified in the Seek to field. |
The time in seconds that you want the Media Player Object to "seek" to. A value of -1 will seek to the end of the media.
This field is only available when the Specific time option is selected.
|
TIP |
|
|
|
|
|
If you want to seek to the end of a media stream only in certain situations, you could conditionally assign -1 to a variable, and use that variable in the Seek to field. |
This action will always fail on a page's (or project's) "On Initialize" event. When the "On Initialize" event occurs, the Media Player Object hasn't been created yet, so there is no media to seek.
This action will always fail on a page's "On Show" event. When the "On Show" event occurs, the Media Player Object has been created, but it hasn't opened any media yet, so there is no media to seek. In other words, the Media Player object exists, but it doesn't have anything "inside it" to seek to.
If you want to seek to a position as soon as the page opens, use this action on the Media Player Object's "On Stream Open" event. (The "On Stream Open" event is the earliest point at which the Media Player Object is ready for seeking.)
|
Value |
Simple Message |
Verbose Message |
|
0 (OK) |
|
|
|
1 |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
|
2 |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
|
3 |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
|
4 |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
|
5 |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
MSG_ERR_SEEK_MEDIA_PLAYER_OBJECT |
None