Collapse all Symbian^3 Application Developer Library

Media Client Observer Overview

This document introduces the Media Client Observer. It is aimed at application developers implementing audio conversion and recording solutions who need to monitor operations for state changes.

Purpose

Media Client Observer provides notifications to monitor and handle events during audio record and convert operations.

Media Client Observer Details

The DLL that provides the functionality and the library to which your code must link is identified below.

DLL	LIB	Short Description
mediaclient.dll	mediaclient.lib	These files are used for implementing the Media Client Observer.

Architectural Relationship

The Audio Client APIs include mediaclient.lib , making the Media Client Observer notifications available.

Description

Media Client Observer is used by Audio Record Utility class ( CMdaAudioRecorderUtility ) and Audio Convert Utility class ( CMdaAudioConvertUtility ) to monitor the state of record and convert operations and triggers a state change event notification.

Key Media Client Observer Classes

This API has a single class:

MMdaObjectStateChangeObserver

monitors the record or convert operation and triggers a stop when notified of a state change.

Using Media Client Observer

Notifications are used when recording or converting audio data as discussed below:

Recording Audio State Change Notifications

When a CMdaAudioRecorderUtility audio recording operation is performed, the MMdaObjectStateChangeObserver is included in the constructor to provide an end of file notification ( KErrEof ).

Converting Audio State Change Notifications

When a CMdaAudioConvertUtility audio conversion operation is performed, the MMdaObjectStateChangeObserver is included in the constructor to provide an end of file notification ( KErrEof ).