seekActiveTime method

Article
08/15/2017

Locates a specified point on the element's active timeline and begins playing from that point.

Syntax

*object.*seekActiveTime(activeTime)

Parameters

activeTime [in]
Type: double

An Integer that specifies a point on the element's active timeline. The element's timeline immediately begins playing from the specified point. Legal values range from 0 to activeDur.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If you attempt to seek to a time on an object that is not currently active, an error is generated. To prevent this, check the object's status using the isActive property.

Not all media types support seeking. In cases where seeking is not supported by the player, calls to seek methods are ignored.

Examples

The following example demonstrates how to use the seekActiveTime method. Before validating and implementing the seekActiveTime value, make sure the object is active, or an error might be generated. In this example, if the object is not active, the beginElement method is called to restart the object, followed by the seekActiveTime method request.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/behaviors/seekactivetime.htm

<HTML xmlns:t= "urn:schemas-microsoft-com:time">
<HEAD>
<TITLE>seekActiveTime Method</TITLE>

<?IMPORT namespace="t" implementation="#default#time2">
<STYLE>
    .time{behavior:url(#default#time2)}
</STYLE>
<SCRIPT>
function doSeekActiveTime(){
    //Is media object active?
    //Yes, continue and do seek.
    //No, restart element using the beginElement method.
    if(!oMedia.currTimeState.isActive){
        oMedia.beginElement();
    }
    //Is user input valid and within the media's duration boundaries?
    if(isFinite(seekActiveTimeInput.value) && seekActiveTimeInput.value
        <= oMedia.mediaDur && seekActiveTimeInput.value > 0){
        oMedia.seekActiveTime(seekActiveTimeInput.value);
    }else{
        //Input is not valid, alert user to re-enter choice.
        alert("Please enter a valid integer. Value must be greater than 0" +
            " seconds and less than the media's duration (" + 
            oMedia.mediaDur + " seconds).");
        seekActiveTimeInput.focus();
    }
}
</SCRIPT>
</HEAD>

<BODY>        
<CENTER>
<B>Media timer:</B>
<SPAN id="Timer2" class="time" dur=".01" repeatCount="indefinite" fill="hold"
    onrepeat="innerText=parseInt(oMedia.currTimeState.activeTime);">0</SPAN>
<BR><BR>
<t:video style="width:175px; height:150px;" id="oMedia"
    src="/workshop/samples/author/behaviors/media/movie.avi"
    onmediacomplete="oMediaDur.innerText=oMedia.mediaDur;" />
<BR>
Media's duration: <SPAN id="oMediaDur"></SPAN>&nbsp;seconds
<BR><BR>
<B>Enter value for seekActiveTime</B>: 
    <INPUT type="text" value="" name="seekActiveTimeInput" size="3"/>&nbsp;seconds
<BR><BR>
<BUTTON id="seekBtn" onClick="doSeekActiveTime();">Click to seek</BUTTON>&nbsp;
<BUTTON onClick="oMedia.beginElement()">Restart</BUTTON>
</CENTER>
</BODY>
</HTML>

Partager via