IToiMediaRecorderObserver Interface Reference


Description

This interface is implemented by applications and is used when creating media recorders. The application will receive asynchronous notifications about media recorder events.

The application provides the address of the IToiMediaRecorderObserver implementation in the IToiMediaService::CreateRecorderInstance() method.

Note:
Services or applications may choose to inherit the adapter class TToiMediaRecorderObserverAdapter, which provides a default empty implementation of IToiMediaRecorderObserver.

import "IToiMediaRecorderObserver.idl";

List of all members.

Public Member Functions

oneway void OnStateChanged (in IToiMediaRecorderBase::TToiMediaRecorderState state, in string reason)
oneway void OnParameterChanged (in string name)

Member Function Documentation

oneway void IToiMediaRecorderObserver::OnParameterChanged ( in string  name  ) 

Tells the observer that the value has changed for one of the parameters that the observer is subscribing to.

Parameters:
name The name of the changed parameter.
See also:
IToiMediaRecorderBase::SubscribeParameter()
oneway void IToiMediaRecorderObserver::OnStateChanged ( in IToiMediaRecorderBase::TToiMediaRecorderState  state,
in string  reason 
)

A call to this function tells the observer that the media recorder state has changed. The application is not notified this way about implicit state changes triggered by commands from the application itself.

Note that there is no timing constraint on these messages, and they may arrive late in certain situations. For example, the application may receive a call to this function about a state transition after the application has successfully called IToiMediaRecorder::Close() and thereby ended the session. This implies that the application should take calls to this function as indications to state transitions that has in fact happened, but it cannot say for certain when these state transitions occured.

Parameters:
state The new state.
reason The reason for the state change.