Export (0) Print
Expand All

SmoothStreamingMediaElement.ScheduleClip Method (ClipInformation, ClipContext, Object)

Schedules playing of a media clip.

Namespace:  Microsoft.Web.Media.SmoothStreaming
Assembly:  Microsoft.Web.Media.SmoothStreaming (in Microsoft.Web.Media.SmoothStreaming.dll)


public ClipContext ScheduleClip(
	ClipInformation clipInfo,
	ClipContext clipToAppendTo,
	Object userData
)

Parameters

clipInfo
Type: Microsoft.Web.Media.SmoothStreaming.ClipInformation
A ClipInformation object that represents the smooth clip to be scheduled.
clipToAppendTo
Type: Microsoft.Web.Media.SmoothStreaming.ClipContext
A ClipContext object to which the new clip will be appended.
userData
Type: System.Object
An object that can contain any data needed by the application, including the SmoothStreamingMediaElement object that will play the clip.

The method inserts a clip that will play for its duration, after which the stream that was interrupted resumes. Clips can be chained together by using this overload of the ScheduleClip(ClipInformation, ClipContext, Object) method. In that case, the clipToAppendTo parameter is set to the ClipContext instance of another clip. For more information and for examples, see Scheduling Media Clips and Microsoft Smooth Streaming Client 2.0.

The object passed in the userData parameter is saved as the Data member of the ClipContext used by the ScheduleClip(ClipInformation, Boolean, Object) method. The application can pass anything it requires in this parameter. The SmoothStreamingMediaElement object is usually included in userData. Later the data can be cast to type SmoothStreamingMediaElement (for example, (SmoothStreamingMediaElement)clipContext.Data) in order to retrieve the Smooth Player that generated the ClipContext instance. If the application requires more information, it can create a class to contain all the information and then pass that type using the userData parameter.

A media clip can be scheduled for play when the SmoothStreamingMediaElement object is in a Closed state by using the ScheduleClip method with the ManifestReady event.

NoteNote

Smooth Streaming clips scheduled by using ScheduleClip methods require manifests that start at timestamp zero and must be scheduled after the manifest is loaded. If you try to schedule a clip when the Smooth Streaming player is in an opening state, an invalidOperationException error occurs. The ScheduleClip should be called only after the ManifestReady event has occurred.

Silverlight

Supported in: 5
Show:
© 2015 Microsoft