/*
* ============================================================================
* Name : about_profiles_example.txt
* Part of : ProfilesExample
* Created : 20.11.2003 by Forum Nokia
* Description:
* The implementation file for audio feedback player.
* Version : 1.0
* Copyright: Nokia Corporation
* ============================================================================
*/
0. Overview (what is this example and what it does)
This profile example is an intoductionary level application implementation
demonstrating the use of profiles API (using CSettingInfo class).
Currently, the profiles API supports reading the profile properties
(ringing volume, vibrating alert mode etc.) and ordering notifications
about the changes of these readable/observable profile properties.
When the application is started, it reads the current profile information
using CSettingInfo class. Secondly, the program orders notifications
about profile change. And at the last initiation operation, the application
loads a single sample file from phone memory, which will be used to give
some audio feedback to the phone user, when a profile changes.
In this text file, the <profiles example dir> is used to REFERENCE to
the directory in which the example files (including this txt file)
have been EXTRACTED.
1. Compatibility
Profiles example application is compatible with S60 2nd Edition. It has been
tested to work with the Nokia 6600 phone.
The S60 2nd Edition SDK is mandatory, because profiles API was first introduced
in this particular release.
2. Building
To build the application, follow the following steps:
2a) go to: "<profiles example dir>\group"
2b) run: "bldmake bldfiles"
Note! Ensure that the sample.wav file located at
<profiles example dir>\data has been copied into:
"c:\Symbian\7.0s\Series60_v20
\Epoc32\wins\c\system\data\"
-directory,
OR under the EPOC root of directory where S60 2nd Edition
SDK has been installed on the target machine.
2c) run: "abld makefile thumb"
2d) run: "abld built thumb urel"
3. Installation to device (pkg file notes & instructions)
3.1 installing the ready-to-use ProfilesExample.SIS file
3.1 a) deliver (move) the ProfilesExample.SIS into
any S60 2nd Edition compatible phone
3.2 building the application from the compiled files
3.2a) go to "<profiles example dir>\install"
3.2b) run: "makesis ProfilesExample.pkg"
3.2c) deliver (move) the created SIS file into
your phone (Nokia 6600 or any S60 2nd Edition compatible phone)
4. Implementation notes
The sample files used is in A-law format. Some of the early
SW releases for the Nokia 6600 phone do not support signed
16 bit PCM format sound files (codec layer did not work).
Therefore, the sample file included with this example is
encode to A-law PCM format to offer the compatibility
in both the Nokia 6600 and emulator.
5. Running the example
Launch the ProfilesExample application on your phone.
A view with a listbox showing your current profile
properties will appear.
Next, press gently the power button of your phone.
The operating systems default profile switching list
will appear. Now, select a new profile for your phone.
The example application should play an audio feedback,
which is a sampled english word (which equals one of
the five default profile names of S60 2nd Edition phone modes:
"general", "silent", "meeting", "outdoor", and "pager".
As long as the profiles example application is running,
it will respond with the appropiate audible English
word being played.
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=8ee92be6-72d4-4619-9b18-9756b6bdb29e/Profiles_Example_v1_0.zip