releasenotes.txt

play stream media file. OS: symbian s60

About Series 60 Platform 1st/2nd Edition: Call Recorder example
---------------------------------------------------------------

This example shows how to record phone calls (from a telephony uplink and a microphone) into wav files.
In addition, the example demonstrates how to play audio files, show a progress 
bar, and use active objects to listen to the phone line.


Prequisities
------------
- Active Objects
- Symbian OS key concepts


Running the Recorder example
----------------------------

The default view is the recording/playing view. The progress bar and time label show if 
the recording utility is active (playing or recording).

Menu options: 

1. Play. Start playing the current audio file from the beginning.
2. Stop. Stop playing and recording.
3. Record. Start recording manually to a new audio file.
4. Record calls automatically.
  4.1 Activate.   When selected, all calls are automatically recorded in a new file.
  4.2 Deactivate. When selected, automatic recording is not used.


Important classes
-----------------
- CScreenUpdateTimer
  When recording or playing, the timer runs every second and updates the screen's
  progress bar and label.
- CPhoneObserver
  When a line listener is activated, the observer listens to the line. When a call is started
  or hung up, the observer calls the RunL method to take the required action (starting or
  stopping the recording, respectively).
- CRecorderAdapter
  Adapter class that uses the CMdaAudioRecorderUtility class for recording and playing.
- CRecorderContainer
  Container class that contains a progress bar and labels. 
  The container is updated by the timer when the recording utility is in use.


Known issues
------------
- Recordings priority must be 80 to record audio calls in Series 60.
- In the Nokia 6620 playback does not work during a voice call (hardware restriction).
- The device microphone cannot be controlled. 
  The SetAudioDeviceMode() method of the class CMdaAudioRecorderUtility does not 
  affect the settings.



Installing instructions
=======================


MOBILE PHONE SDK 1.2
--------------------
go to /recorder/groupS6012
bldmake bldfiles
abld build armi urel
go to /recorder/sis
makesis Series60_v12_recorder.pkg
install .sis to your phone

MOBILE PHONE SDK 2.1
------------------
go to /recorder/groupS6021
bldmake bldfiles
abld build armi urel
go to /recorder/sis
makesis Series60_v21_recorder.pkg
install .sis to your phone

EMULATOR SDK 1.2
------------------
go to /recorder/groupS6012
bldmake bldfiles
abld build wins udeb
start the emulator

EMULATOR SDK 2.1
------------------
go to /recorder/groupS6021
bldmake bldfiles
abld build wins udeb
start the emulator


Compiled with series 60 SDK v2.1 and series 60 SDK v1.2.
Tested with:
 Nokia 3650
 Nokia 6600
 Nokia 6630
 Nokia 6670