org.kurento.client

Interface PlayerEndpoint

All Superinterfaces:

Endpoint, KurentoObject, MediaElement, MediaObject, UriEndpoint

public interface PlayerEndpoint
extends UriEndpoint

Retrieves content from seekable or non-seekable sources, and injects them into KMS, so they can be delivered to any Filter or Endpoint in the same MediaPipeline. Following URI schemas are supported:

• Files: Mounted in the local file system.
  • file:///path/to/file
• RTSP: Those of IP cameras would be a good example.
  • rtsp://
  • rtsp://username:password@
• HTTP: Any file available in an HTTP server
  • http(s):///path/to/file
  • http(s)://username:password@/path/to/file

For the player to stream the contents of the file, the server must have access to the resource. In case of local files, the user running the process must have read permissions over the file. For network resources, the path to the resource must be accessible: IP and port access not blocked, correct credentials, etc.The resource location can’t be changed after the player is created, and a new player should be created for streaming a different resource.

The list of valid operations is

• *play*: starts streaming media. If invoked after pause, it will resume playback.
• *stop*: stops streaming media. If play is invoked afterwards, the file will be streamed from the beginning.
• *pause*: pauses media streaming. Play must be invoked in order to resume playback.
• *seek*: If the source supports “jumps” in the timeline, then the PlayerEndpoint can
  • *setPosition*: allows to set the position in the file.
  • *getPosition*: returns the current position being streamed.

Events fired:

• EndOfStreamEvent: If the file is streamed completely.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	PlayerEndpoint.Builder

Method Summary

Modifier and Type	Method and Description
ListenerSubscription	addEndOfStreamListener(EventListener<EndOfStreamEvent> listener) Add a EventListener for event EndOfStreamEvent.
void	addEndOfStreamListener(EventListener<EndOfStreamEvent> listener, Continuation<ListenerSubscription> cont) Add a EventListener for event EndOfStreamEvent.
String	getElementGstreamerDot() Get Returns the GStreamer DOT string for this element's private pipeline
void	getElementGstreamerDot(Continuation<String> cont) Get Returns the GStreamer DOT string for this element's private pipeline
TFuture<String>	getElementGstreamerDot(Transaction tx) Get Returns the GStreamer DOT string for this element's private pipeline
long	getPosition() Get Get or set the actual position of the video in ms.
void	getPosition(Continuation<Long> cont) Get Get or set the actual position of the video in ms.
TFuture<Long>	getPosition(Transaction tx) Get Get or set the actual position of the video in ms.
VideoInfo	getVideoInfo() Get Returns info about the source being played
void	getVideoInfo(Continuation<VideoInfo> cont) Get Returns info about the source being played
TFuture<VideoInfo>	getVideoInfo(Transaction tx) Get Returns info about the source being played
void	play() Starts reproducing the media, sending it to the :rom:cls:`MediaSource`.
void	play(Continuation<Void> cont) Asynchronous version of play: Continuation.onSuccess(F) is called when the action is done.
void	play(Transaction tx) Starts reproducing the media, sending it to the :rom:cls:`MediaSource`.
void	removeEndOfStreamListener(ListenerSubscription listenerSubscription) Remove a ListenerSubscription for event EndOfStreamEvent.
void	removeEndOfStreamListener(ListenerSubscription listenerSubscription, Continuation<Void> cont) Remove a ListenerSubscription for event EndOfStreamEvent.
void	setPosition(long position) Set Get or set the actual position of the video in ms.
void	setPosition(long position, Continuation<Void> cont) Set Get or set the actual position of the video in ms.
void	setPosition(long position, Transaction tx) Set Get or set the actual position of the video in ms.

Methods inherited from interface org.kurento.client.UriEndpoint

addUriEndpointStateChangedListener, addUriEndpointStateChangedListener, getState, getState, getState, getUri, getUri, getUri, pause, pause, pause, removeUriEndpointStateChangedListener, removeUriEndpointStateChangedListener, stop, stop, stop

Methods inherited from interface org.kurento.client.MediaElement

addElementConnectedListener, addElementConnectedListener, addElementDisconnectedListener, addElementDisconnectedListener, addMediaFlowInStateChangeListener, addMediaFlowInStateChangeListener, addMediaFlowOutStateChangeListener, addMediaFlowOutStateChangeListener, addMediaTranscodingStateChangeListener, addMediaTranscodingStateChangeListener, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, getGstreamerDot, getGstreamerDot, getGstreamerDot, getGstreamerDot, getGstreamerDot, getGstreamerDot, getMaxOuputBitrate, getMaxOuputBitrate, getMaxOuputBitrate, getMaxOutputBitrate, getMaxOutputBitrate, getMaxOutputBitrate, getMinOuputBitrate, getMinOuputBitrate, getMinOuputBitrate, getMinOutputBitrate, getMinOutputBitrate, getMinOutputBitrate, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getStats, getStats, getStats, getStats, getStats, getStats, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, removeElementConnectedListener, removeElementConnectedListener, removeElementDisconnectedListener, removeElementDisconnectedListener, removeMediaFlowInStateChangeListener, removeMediaFlowInStateChangeListener, removeMediaFlowOutStateChangeListener, removeMediaFlowOutStateChangeListener, removeMediaTranscodingStateChangeListener, removeMediaTranscodingStateChangeListener, setAudioFormat, setAudioFormat, setAudioFormat, setMaxOuputBitrate, setMaxOuputBitrate, setMaxOuputBitrate, setMaxOutputBitrate, setMaxOutputBitrate, setMaxOutputBitrate, setMinOuputBitrate, setMinOuputBitrate, setMinOuputBitrate, setMinOutputBitrate, setMinOutputBitrate, setMinOutputBitrate, setOutputBitrate, setOutputBitrate, setOutputBitrate, setVideoFormat, setVideoFormat, setVideoFormat

Methods inherited from interface org.kurento.client.MediaObject

addErrorListener, addErrorListener, addTag, addTag, addTag, getChildren, getChildren, getChildren, getChilds, getChilds, getChilds, getCreationTime, getCreationTime, getCreationTime, getId, getId, getId, getMediaPipeline, getMediaPipeline, getMediaPipeline, getName, getName, getName, getParent, getParent, getParent, getSendTagsInEvents, getSendTagsInEvents, getSendTagsInEvents, getTag, getTag, getTag, getTags, getTags, getTags, removeErrorListener, removeErrorListener, removeTag, removeTag, removeTag, setName, setName, setName, setSendTagsInEvents, setSendTagsInEvents, setSendTagsInEvents

Methods inherited from interface org.kurento.client.KurentoObject

isCommited, release, release, release, waitCommited, whenCommited, whenCommited

Method Detail

getVideoInfo

VideoInfo getVideoInfo()

Get Returns info about the source being played

getVideoInfo

void getVideoInfo(Continuation<VideoInfo> cont)

Get Returns info about the source being played

getVideoInfo

TFuture<VideoInfo> getVideoInfo(Transaction tx)

Get Returns info about the source being played

getElementGstreamerDot

String getElementGstreamerDot()

Get Returns the GStreamer DOT string for this element's private pipeline

getElementGstreamerDot

void getElementGstreamerDot(Continuation<String> cont)

Get Returns the GStreamer DOT string for this element's private pipeline

getElementGstreamerDot

TFuture<String> getElementGstreamerDot(Transaction tx)

Get Returns the GStreamer DOT string for this element's private pipeline

getPosition

long getPosition()

Get Get or set the actual position of the video in ms. Note Setting the position only works for seekable videos

getPosition

void getPosition(Continuation<Long> cont)

Get Get or set the actual position of the video in ms. Note Setting the position only works for seekable videos

getPosition

TFuture<Long> getPosition(Transaction tx)

Get Get or set the actual position of the video in ms. Note Setting the position only works for seekable videos

setPosition

void setPosition(long position)

Set Get or set the actual position of the video in ms. Note Setting the position only works for seekable videos

setPosition

void setPosition(long position,
                 Continuation<Void> cont)

Set Get or set the actual position of the video in ms. Note Setting the position only works for seekable videos

setPosition

void setPosition(long position,
                 Transaction tx)

Set Get or set the actual position of the video in ms. Note Setting the position only works for seekable videos

play

void play()

Starts reproducing the media, sending it to the :rom:cls:`MediaSource`. If the endpoint has been connected to other endpoints, those will start receiving media.

play

void play(Continuation<Void> cont)

Asynchronous version of play: Continuation.onSuccess(F) is called when the action is done. If an error occurs, Continuation.onError(java.lang.Throwable) is called.

See Also:

play()

play

void play(Transaction tx)

Starts reproducing the media, sending it to the :rom:cls:`MediaSource`. If the endpoint has been connected to other endpoints, those will start receiving media.

addEndOfStreamListener

ListenerSubscription addEndOfStreamListener(EventListener<EndOfStreamEvent> listener)

Add a EventListener for event EndOfStreamEvent. Synchronous call.

Parameters:

listener - Listener to be called on EndOfStreamEvent

Returns:

ListenerSubscription for the given Listener

addEndOfStreamListener

void addEndOfStreamListener(EventListener<EndOfStreamEvent> listener,
                            Continuation<ListenerSubscription> cont)

Add a EventListener for event EndOfStreamEvent. Asynchronous call. Calls Continuation<ListenerSubscription> when it has been added.

Parameters:

listener - Listener to be called on EndOfStreamEvent

cont - Continuation to be called when the listener is registered

removeEndOfStreamListener

void removeEndOfStreamListener(ListenerSubscription listenerSubscription)

Remove a ListenerSubscription for event EndOfStreamEvent. Synchronous call.

Parameters:

listenerSubscription - Listener subscription to be removed

removeEndOfStreamListener

void removeEndOfStreamListener(ListenerSubscription listenerSubscription,
                               Continuation<Void> cont)

Remove a ListenerSubscription for event EndOfStreamEvent. Asynchronous call. Calls Continuation<Void> when it has been removed.

Parameters:

listenerSubscription - Listener subscription to be removed

cont - Continuation to be called when the listener is removed