readme-ringertest.txt

复件 使用IRINGERMGR接口设置手机铃声的例子

Readme for ringertest, version 1.0
Nov. 11, 2003
Copyright (c) 2003 Unicom-BREW Technologies. All rights reserved.

=====================
DESCRIPTION
=====================

This application is to test the IRingerMgr Interface. It implements the following functions:

1. Create: Create ring0.mid and ring1.mid as ringtones using IRINGERMGR_Create();

2. EnumCategory: Enumerate the ringer category using IRINGERMGR_EnumCategoryInit() and IRINGERMGR_EnumNextCategory();

3. EnumRinger: Enumerate the ringers on the BREW ringer directory using IRINGERMGR_EnumRingerInit() and IRINGERMGR_EnumNextRinger();

4. RingerFormat: Get device supported ringer formats using IRinger_GetNumberFormats() & Ringer_GetFormats();

5. Play: Get the first ringer ID and play it using IRINGERMGR_Play();

6. SetRinger: Set the first ringer as the default ringtone of the second category using IRINGERMGR_SetRinger();

7. Remove: Remove the first ringer using IRINGERMGR_Remove().

=====================
BUILD INSTRUCTIONS
=====================

Emulator:
Assumption: you have BREW SDK 2.0, BREW Tool Suite and Microsoft Visuall C++ 6.0 installed.

Open RingerTest.dsw in Microsoft Visual C++ 6.0, select Build All, and run it on the emulator. (Make sure you have not put ANY .sig file under the ths directory, or it can't be executed on the emulator).

Device:
Assumption: you have BREW SDK 2.0, BREW Tool Suite and Gnude(Gnu GCC for ARM Compiler) installed.

From a Windows "cmd" shell, cd to this extracted location, compile the application, "make -f ringertest.mak".

Copy ringer.mif to the root directory on your device;
Create ringertest directory on the root directory;
Copy ringertest.mod, ringer0.mid and ringer1.mid to ringertest directory; 
Generate a signature file according to your device, name it ringertest.sig, put it to ringertest directory.
Restart the device and run it.

=====================
Known Issues:
=====================

Suspend & Resume events are not handled, so application may be terminated abnormally when these events occur.