diff -r 000000000000 -r 89d6a7a84779 Symbian3/SDK/Source/GUID-21D0D9D5-B57F-5F16-A2AF-17BC00DC1B15-GENID-1-6-1-17-1-1-5-1-7-1-6-1-3-1.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-21D0D9D5-B57F-5F16-A2AF-17BC00DC1B15-GENID-1-6-1-17-1-1-5-1-7-1-6-1-3-1.dita Thu Jan 21 18:18:20 2010 +0000 @@ -0,0 +1,48 @@ + + + + + +AudioClientEx: +Multimedia audio example code +
Description

AudioClientEx demonstrates +the use of the Multimedia Framework's client audio interfaces. It allows the +user to:

    +

  • choose a tone to play

    • +

  • choose a file to play

    • +

  • choose a file to convert +to another format

    • +

  • record to a file

    • +

  • play a streaming source

    • +

  • set the volume

    • +

The Multimedia Framework APIs are called by the example's engine +class, CMediaClientEngine. This also implements the various +callback interfaces required by the APIs in order to report progress and error +conditions. Each of the play options (tone, file, stream) is handled by a +separate overload of the PlayL() function. Recording is started +through RecordL(). The current operation can always be terminated +through Stop().

The engine is driven through the +example's UI class CMediaClientAppUi. The engine notifies +the UI of significant events by calling its HandleEngineState() function. +The UI uses this to update text describing the current activity appropriately.

Interaction +between the UI and engine is in most cases simple. Streaming however is more +complex. To simulate a streaming data source (e.g. an audio stream being received +over the Internet), the UI creates a timer object that periodically passes +slices of data (read from a file) to the engine.

+
Download

Click +on the following link to download the example: AudioClient.zip file

Click: browse to view the example code.

+
Class summary

CMdaAudioToneUtility CMdaAudioPlayerUtility CMdaAudioRecorderUtility CMdaAudioOutputStream CMdaAudioConvertUtility TMdaAudioDataSettings RMetaDataArray TFormatOptions TRecordFormatOptions

+
Usage

Commands are given to the example through +its Actions and Options menus. For tone play, the user is asked to specify +a pitch and duration; for file play, conversion, and recording, the user is +asked to specify a file, and any available format options. The audio data +source for streaming in the example is a preset file, so this command does +not require further input.

A sample file, note.wav is +put by the example on the emulator's C drive for file play.

+ \ No newline at end of file