MediaController::Controller Class Reference

Implements the IController interface methods. More...

#include <Controller.h>

Public Member Functions
	Controller (MediaRequest &request)
	Constructor. More...
virtual	~Controller ()
	Virtual destructor. More...
void	SetWindow (void *handle) override
	Set the display window using the given window handle. More...
bool	GoToLive () override
	Set the stream to Live and call Play. More...
bool	Play (float speed, unsigned int unixTime) override
	Call Play on the stream. More...
void	PlayStream (float speed, unsigned int unixTime) override
void	Pause () override
	Call Pause on the stream. More...
void	Stop () override
	Call TearDown on the stream. More...
void	NewRequest (MediaRequest &request) override
	Set the stream to a new source. More...
void	AddObserver (TimestampEventCallback observer) override
	Add a new subscriber to timestamp events. More...
void	RemoveObserver (TimestampEventCallback observer) override
	Remove an existing timestamp event subscriber. More...
void	ClearObservers () override
	Remove all existing timestamp event subscribers. More...
Mode	GetMode () override
	Get the current playback mode. More...
bool	IsPipelineActive () override
	Get the status of the pipeline. More...
void	AddEventData (void *customData) override
	Add event data to be send back during timestamp events. More...
Public Member Functions inherited from MediaController::IController
virtual	~IController ()
	Virtual destructor. More...
Public Member Functions inherited from MediaController::IStream
virtual	~IStream ()
	Virtual destructor. More...

Public Attributes
StreamBase *	stream
	The current video stream instance. More...
StreamBase *	audioStream
	The current audio stream instance. More...

Static Private Member Functions
static void	CallSetupStream (StreamBase *stream, float speed, unsigned int unixTime, bool *result)
static void	CallPlayStream (StreamBase *stream, float speed, unsigned int unixTime)

Additional Inherited Members
Public Types inherited from MediaController::IStream
enum	Mode {   kStopped,   kLive,   kPlayback }
	Values that represent the different playback modes. More...

Detailed Description

Implements the IController interface methods.

Definition at line 14 of file Controller.h.

Inherits MediaController::IController.

Constructor & Destructor Documentation

Controller::Controller

(

MediaRequest &

request

)

Constructor.

Parameters

request

The requested media.

Definition at line 30 of file Controller.cpp.

                                            {
    this->stream = StreamFactory::CreateStream(request);
    this->audioStream = StreamFactory::CreateAudioStream(request);
}

Controller::~Controller ( )

virtual

Virtual destructor.

Definition at line 35 of file Controller.cpp.

                        {
    if (this->stream != nullptr) {
        delete this->stream;
        this->stream = nullptr;
    }

    if (this->audioStream != nullptr) {
        delete this->audioStream;
        this->audioStream = nullptr;
    }
}

Member Function Documentation

void Controller::AddEventData ( void *  customData )

overridevirtual

Add event data to be send back during timestamp events.

Parameters

customData

Custom data pointer.

Implements MediaController::IController.

Definition at line 150 of file Controller.cpp.

                                              {
    if (this->stream != nullptr)
        this->stream->GetGstreamer()->AddEventData(customData);
}

void Controller::AddObserver ( TimestampEventCallback  observer )

overridevirtual

Add a new subscriber to timestamp events.

Parameters

observer

The TimestampEventCallback event handler.

Implements MediaController::IController.

Definition at line 145 of file Controller.cpp.

                                                            {
    if (this->stream != nullptr)
        this->stream->GetGstreamer()->AddObserver(observer);
}

void Controller::CallPlayStream ( StreamBase *  stream, float  speed, unsigned int  unixTime  )

staticprivate

Definition at line 123 of file Controller.cpp.

                                                                                      {
    if (stream != nullptr) {
        stream->PlayStream(speed, unixTime);
    }
}

void Controller::CallSetupStream ( StreamBase *  stream, float  speed, unsigned int  unixTime, bool *  result  )

staticprivate

Definition at line 117 of file Controller.cpp.

                                                                                                     {
    if (stream != nullptr) {
        *result = stream->state->Play(*stream, speed, unixTime);
    }
}

void Controller::ClearObservers ( )

overridevirtual

Remove all existing timestamp event subscribers.

Implements MediaController::IController.

Definition at line 160 of file Controller.cpp.

                                {
    if (this->stream != nullptr)
        this->stream->GetGstreamer()->ClearObservers();
}

Controller::Mode Controller::GetMode ( )

overridevirtual

Get the current playback mode.

Returns

The current stream Mode.

Implements MediaController::IStream.

Definition at line 165 of file Controller.cpp.

                                   {
    if (this->stream != nullptr)
        return this->stream->GetGstreamer()->GetMode();

    return Controller::Mode::kStopped;
}

bool Controller::GoToLive ( )

overridevirtual

Set the stream to Live and call Play.

Implements MediaController::IStream.

Definition at line 62 of file Controller.cpp.

                          {
    bool result = true;
    if (this->stream != nullptr) {
        result &= this->stream->state->GoToLive(*this->stream);
        CallPlayStream(this->stream, 0, 0);
    }

    if (this->audioStream != nullptr) {
        result &= this->audioStream->state->GoToLive(*this->audioStream);
        CallPlayStream(this->audioStream, 0, 0);
    }

    return result;
}

bool Controller::IsPipelineActive ( )

overridevirtual

Get the status of the pipeline.

Returns

True if pipeline is active, otherwise false.

Implements MediaController::IController.

Definition at line 172 of file Controller.cpp.

                                  {
    if (this->stream != nullptr)
        return this->stream->GetGstreamer()->IsPipelineActive();
    return false;
}

void Controller::NewRequest ( MediaRequest &  request )

overridevirtual

Set the stream to a new source.

Parameters

request

The new MediaRequest to reset the stream to.

Implements MediaController::IStream.

Definition at line 52 of file Controller.cpp.

                                                 {
    if (this->stream != nullptr)
        this->stream->NewRequest(request);

    if (this->audioStream != nullptr) {
        MediaRequest* audioRequest = StreamFactory::CreateMediaRequest(request);
        this->audioStream->NewRequest(*audioRequest);
    }
}

void Controller::Pause ( )

overridevirtual

Call Pause on the stream.

Implements MediaController::IStream.

Definition at line 129 of file Controller.cpp.

                       {
    if (this->stream != nullptr)
        this->stream->state->Pause(*this->stream);

    if (this->audioStream != nullptr)
        this->audioStream->state->Pause(*this->audioStream);
}

bool Controller::Play ( float  speed, unsigned int  unixTime  )

overridevirtual

Call Play on the stream.

Parameters

speed	The playback speed. Negative values can be used for reverse playback. A value of 0 will resume a paused stream.
unixTime	The start time for playback. A value of 0 will start a live stream.

Implements MediaController::IStream.

Definition at line 77 of file Controller.cpp.

                                                        {
    // Setup audio stream in new thread
    bool audioResult = true;
    boost::thread* t1 = nullptr;
    if (this->audioStream != nullptr) {
        t1 = new boost::thread(CallSetupStream, this->audioStream, speed, unixTime, &audioResult);
    }

    // Setup video stream in main thread
    bool videoResult = true;
    CallSetupStream(this->stream, speed, unixTime, &videoResult);

    // Wait for audio stream to complete
    if (t1 != nullptr)
        t1->join();

    if (!videoResult || !audioResult)
        return false;

    // Create pipeline for audio stream in new thread
    boost::thread* t2 = nullptr;
    if (audioResult) {
        t2 = new boost::thread(CallPlayStream, this->audioStream, speed, unixTime);
    }

    // Create pipeline for video stream in main thread
    if (videoResult) {
        CallPlayStream(this->stream, speed, unixTime);
    }

    // Wait for audio stream to complete
    if (t2 != nullptr)
        t2->join();

    return true;
}

void Controller::PlayStream ( float  speed, unsigned int  unixTime  )

overridevirtual

Implements MediaController::IStream.

Definition at line 114 of file Controller.cpp.

                                                              {
}

void Controller::RemoveObserver ( TimestampEventCallback  observer )

overridevirtual

Remove an existing timestamp event subscriber.

Parameters

observer

The TimestampEventCallback event handler.

Implements MediaController::IController.

Definition at line 155 of file Controller.cpp.

                                                               {
    if (this->stream != nullptr)
        this->stream->GetGstreamer()->RemoveObserver(observer);
}

void Controller::SetWindow ( void *  handle )

overridevirtual

Set the display window using the given window handle.

Parameters

handle

The window handle of the display.

Implements MediaController::IController.

Definition at line 47 of file Controller.cpp.

                                       {
    if (this->stream != nullptr)
        this->stream->GetGstreamer()->SetWindowHandle(guintptr(handle));
}

void Controller::Stop ( )

overridevirtual

Call TearDown on the stream.

Implements MediaController::IStream.

Definition at line 137 of file Controller.cpp.

                      {
    if (this->stream != nullptr)
        this->stream->state->Stop(*this->stream);

    if (this->audioStream != nullptr)
        this->audioStream->state->Stop(*this->audioStream);
}

Member Data Documentation

StreamBase* MediaController::Controller::audioStream

The current audio stream instance.

Definition at line 49 of file Controller.h.

StreamBase* MediaController::Controller::stream

The current video stream instance.

Definition at line 44 of file Controller.h.

---

The documentation for this class was generated from the following files:

• C:/Git/VxSDK-Samples/MediaController/Include/Controller.h
• C:/Git/VxSDK-Samples/MediaController/Source/Controller.cpp