S60 Platform: Audio Streaming Example v2.0
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
   
Audio Streaming Example demonstrates the use of Audio Streaming API that 
provides functionality for recording audio stream into a buffer, and playback
of the audio buffer. The application uses CMdaAudioInputStream for audio input and CMdaAudioOutputStream for audio output, and their respective callback classes MMdaAudioInputStreamCallback and MMdaAudioOutputStreamCallback. Operations for 
playing, recording, and stopping the audio stream are available. Also, the 
recorded audio stream can be saved into a file and further loaded to be played 
again.
 
Audio Streaming API is part of the Symbian Multimedia Framework (MMF) and 
supported from S60 2nd Edition onwards.

The example package contains two audio sample files - sample.aud and sample.amr - 
in the data directory. The first one uses the default PCM encoding and the latter
is an AMR-NB-encoded file. The samples are recorded using this application on a 
Nokia N90 device.


   
--------------------------------------------------------------------------------

PREREQUISITES

- Symbian OS key concepts

--------------------------------------------------------------------------------

IMPORTANT CLASSES

CAudioStreamEngine	
	The main engine class. Handles the input and output streams 
	and implements the callback methods defined in the mixin classes 
	MMdaAudioInputStreamCallback and MMdaAudioOutputStreamCallback.
	

--------------------------------------------------------------------------------

KNOWN ISSUES

No known issues

--------------------------------------------------------------------------------

RUNNING THE EXAMPLE

Launch the Audio Stream application on your phone.
A canvas displaying application name will appear and the
application is ready for use.

The operations of the application are controlled
using the actions found in the menu:

* Record

Records incoming audio stream for a few seconds or until stopped.  

* Play 
	
Plays the audio data stored in the buffer.

*Stop 
	
Stops recording or playing audio data.
  
*Save 
	
Stores the audio data stored in the buffer into a file.  

*Load
	
Loads the audio data from file into the buffer.



--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS

MOBILE DEVICE (S60 3rd Edition)
------------------
    Go to /AudioStreamExample/group
    bldmake bldfiles
    Note! Ensure that the sample.aud/amr files located at
   	/AudioStreamExample/data have been copied to /epoc32/winscw/c/private/e01ff1c3/
	in your SDK installation directory

    abld build gcce urel
    Go to /AudioStreamExample/sis
    Edit the AudioStreamEx_s60_3rd_ed.pkg's paths to match those on your system.
    makesis AudioStreamEx_s60_3rd_ed.pkg
    
    Sign the SIS package:
	Sign the sis file (for more information about signing the sis file and 
        developer certificate, visit www.symbiansigned.com):
        signsis AudioStreamEx_s60_3rd_ed.sis AudioStreamEx3rdEd.sis YourCertificate.cer 
           YourKey.key YourPassword

    Install the signed .sis file into a S60 3rd Edition device.

MOBILE DEVICE (S60 2nd Edition)
------------------
    Go to /AudioStreamExample/group
    bldmake bldfiles
    Note! Ensure that the sample.aud/amr files located at
   	/AudioStreamExample/data have been copied to /epoc32/winscw/c/system/Apps/audiostream/
	in your SDK installation directory

    abld build thumb urel
    Go to /AudioStreamExample/sis
    Edit the AudioStreamEx.pkg's paths to match those on your system.
    makesis AudioStreamEx.pkg
    Install the .sis file to your device

EMULATOR (S60 3rd Edition)
------------------
    Go to /AudioStreamExample/group
    bldmake bldfiles
    Note! Ensure that the sample.aud/amr files located at
   	/AudioStreamExample/data have been copied to /epoc32/winscw/c/private/e01ff1c3/
	in your SDK installation directory

    abld build wins udeb
    Start the emulator

EMULATOR (S60 2nd Edition)
------------------
    Go to /AudioStreamExample/group
    bldmake bldfiles
    Note! Ensure that the sample.aud/amr files located at
   	/AudioStreamExample/data have been copied to /epoc32/winscw/c/system/Apps/audiostream/
	in your SDK installation directory

    abld build wins udeb
    Start the emulator

--------------------------------------------------------------------------------

COMPATIBILITY

S60 3rd Edition
S60 2nd Edition

TESTED WITH Nokia 6670, Nokia 6630, Nokia N90, Nokia E60
Created / tested with S60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 2, for C++, Supporting Metrowerks CodeWarrior
and S60 3rd Edition SDK for Symbian OS, for C++, Supporting Metrowerks CodeWarrior

--------------------------------------------------------------------------------

VERSION HISTORY

2.0 (June 22, 2006)	Added support for S60 3rd Edition and AMR-NB encoding. Changed the buffer sizes to match
			the requirements of S60 3rd Edition and S60 2nd Edition FP2/FP3 devices.

1.0 (January 20, 2004)	First release.

--------------------------------------------------------------------------------
EVALUATE THIS RESOURCE   

Please spare a moment to help us improve documentation quality 
and recognize the examples you find most valuable, by rating this resource at 
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId=471b4e01-d115-406a-b144-7b3b2832a804/S60_Platform_Audio_Streaming_Example_v2_0_en.zip