danger.audio
Class ToneGallery

java.lang.Object
  |
  +--danger.app.Listener
        |
        +--danger.audio.ToneGallery

All Implemented Interfaces:

danger.audio.ToneGalleryList

public class ToneGallery

extends Listener

implements danger.audio.ToneGalleryList

Inner Class Summary

static interface	ToneGallery.Errors
static interface	ToneGallery.Type

Field Summary

static java.lang.String	kBeeps
static java.lang.String	kChimesBack
static java.lang.String	kChimesFore
static java.lang.String	kDiscreet
static java.lang.String	kHiddenTag
static java.lang.String	kPhone
static java.lang.String	kSongs
static java.lang.String	kUI
static java.lang.String	kUnmutable
static java.lang.String	kVoice
static Tone[]	mTonePoolStatic

Method Summary

static void	add(int type, byte[] data, java.lang.String name, int resourceID, Event successCallback, Event failureCallback, int origin, boolean showNotification)
static void	add(int type, byte[] data, java.lang.String name, java.lang.String productID, Event successCallback, Event failureCallback, int origin, boolean showNotification) Main entry to add a ringtone into the tone gallery.
static void	displayState()
static int	generateResourceID()
static RingToneObject	getDefaultCallRingTone() Get the default ringtone used for phone
static RingToneObject	getDefaultVoicemailRingTone()
static int	getFiltersFromID(int resourceID)
static java.lang.String	getGroupNameFromID(int resourceID)
static java.util.Vector	getGroupNames()
static java.util.Vector	getGroupNames(int klass)
static int	getIDFromNameAndGroup(java.lang.String name, java.lang.String group)
static java.util.Vector	getListOfStoredTones()
static java.lang.String	getNameFromID(int resourceID)
static java.util.Vector	getNamesFromGroup(java.lang.String group, int klass) Return names from a specific group as String object stored as a Vector object
static java.util.Vector	getProductIDs()
static int	getToneClassFromID(int resourceID)
static Tone	getToneFromID(int resourceID)
static boolean	hasBuzzer(int resourceID)
static boolean	hasFlasher(int resourceID)
static boolean	hasSound(int resourceID)
static void	initialize()
static void	initializeFromSysApp()
static boolean	isChanged()
static boolean	isInstalled(java.lang.String productID) returns true/false if a particular Tone is installed into the ToneGallery, based upon productID or/and resourceID.
static boolean	isInstalled(java.lang.String productID, int resourceID)
static boolean	isNameInGroup(java.lang.String name, java.lang.String group)
static void	listTones(int klass)
static void	playAllTones()
static void	playTonesByClass(int klass)
boolean	receiveEvent(Event e) Entry point for event processing.
static int	register(Tone tone)
static int	register(Tone[] toneList, int klass)
static int	register(ToneRecordStore toneStore) Register a set of Tones.
static void	remove(int resourceID)
static void	remove(java.lang.String productID)
static void	remove(Tone tone)
static void	removeAllStored()
static void	setDefaultCallRingTone(RingToneObject ringtone) Set the default ringtone use for the phone
static void	setDefaultVoicemailRingTone(RingToneObject ringtone)
static void	setNameFromID(int resourceID, java.lang.String newName)
static int	setVolumeFromID(int resourceID, int newVolume)
static void	showDeleteRingToneDialog(Event successCallback, Event failureCallback)

Methods inherited from class danger.app.Listener

cancelEvents, receiveEventInternal, sendEvent, sendEvent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

kVoice

public static final java.lang.String kVoice

kBeeps

public static final java.lang.String kBeeps

kChimesFore

public static final java.lang.String kChimesFore

kChimesBack

public static final java.lang.String kChimesBack

kDiscreet

public static final java.lang.String kDiscreet

kSongs

public static final java.lang.String kSongs

kHiddenTag

public static final java.lang.String kHiddenTag

kUI

public static final java.lang.String kUI

kUnmutable

public static final java.lang.String kUnmutable

kPhone

public static final java.lang.String kPhone

mTonePoolStatic

public static final Tone[] mTonePoolStatic

Method Detail

initialize

public static void initialize()

initializeFromSysApp

public static void initializeFromSysApp()

setDefaultCallRingTone

public static void setDefaultCallRingTone(RingToneObject ringtone)

Set the default ringtone use for the phone

getDefaultCallRingTone

public static RingToneObject getDefaultCallRingTone()

Get the default ringtone used for phone

setDefaultVoicemailRingTone

public static void setDefaultVoicemailRingTone(RingToneObject ringtone)

getDefaultVoicemailRingTone

public static RingToneObject getDefaultVoicemailRingTone()

register

public static int register(ToneRecordStore toneStore)

Register a set of Tones. This is used to include a individul Tone, or a list of Tones in the ToneGallery. This doesn't limit the number of tones added. The ToneGalleryStore uses these methods to include a ringtone brought down from the serivce Returns: Errors.OK Errors.NOT_SETUP Errors.DUPLICATE_ID

register

public static int register(Tone tone)

register

public static int register(Tone[] toneList,
                           int klass)

generateResourceID

public static int generateResourceID()

isChanged

public static boolean isChanged()

showDeleteRingToneDialog

public static void showDeleteRingToneDialog(Event successCallback,
                                            Event failureCallback)

isInstalled

public static boolean isInstalled(java.lang.String productID)

returns true/false if a particular Tone is installed into the ToneGallery, based upon productID or/and resourceID. Either can be 0, if not known.

isInstalled

public static boolean isInstalled(java.lang.String productID,
                                  int resourceID)

add

public static void add(int type,
                       byte[] data,
                       java.lang.String name,
                       java.lang.String productID,
                       Event successCallback,
                       Event failureCallback,
                       int origin,
                       boolean showNotification)

Main entry to add a ringtone into the tone gallery. Add() will add a ringtone and queue up any multiple adds. This will also open a delete ringtone dialog if the gallery becomes full. INPUT: type ToneGallery.Type.*. If type is UNKNOWN, this will try and determine what type of data it is and continue. data byte data. name optional name, if not provided, then data will be parsed to determine if one is available, if not, then one will be assigned. productID unique id. Use null to generate one. successCallback Listener object to call after successfull install failureCallback Listener object to call after failed install origin Tone.Origin.*. Location of where data comes from which determines how its stored in the gallery. Tone.Origin.kGallery - Added to the gallery but not saved to the service Tone.Origin.kUser - Added to service store. Full access. Tone.Origin.kPDM - Added only to local store. Controlled access. Tone.Origin.kPDMBackup - Added to service store. Controlled access. showNotification If true, a notification will be started after install.

add

public static void add(int type,
                       byte[] data,
                       java.lang.String name,
                       int resourceID,
                       Event successCallback,
                       Event failureCallback,
                       int origin,
                       boolean showNotification)

receiveEvent

public boolean receiveEvent(Event e)

Description copied from class: Listener

Entry point for event processing. Default behaviour is to do nothing and return false. Normally this method is called from a Dispatcher when it discovers an Event in its queue that is targetted at this Listener.

Overrides:

receiveEvent in class Listener

remove

public static void remove(java.lang.String productID)

remove

public static void remove(int resourceID)

remove

public static void remove(Tone tone)

removeAllStored

public static void removeAllStored()

getToneClassFromID

public static int getToneClassFromID(int resourceID)

getFiltersFromID

public static int getFiltersFromID(int resourceID)

hasSound

public static boolean hasSound(int resourceID)

hasBuzzer

public static boolean hasBuzzer(int resourceID)

hasFlasher

public static boolean hasFlasher(int resourceID)

setVolumeFromID

public static int setVolumeFromID(int resourceID,
                                  int newVolume)

setNameFromID

public static void setNameFromID(int resourceID,
                                 java.lang.String newName)

getNameFromID

public static java.lang.String getNameFromID(int resourceID)

getGroupNameFromID

public static java.lang.String getGroupNameFromID(int resourceID)

getToneFromID

public static Tone getToneFromID(int resourceID)

getGroupNames

public static java.util.Vector getGroupNames(int klass)

getProductIDs

public static java.util.Vector getProductIDs()

getGroupNames

public static java.util.Vector getGroupNames()

getNamesFromGroup

public static java.util.Vector getNamesFromGroup(java.lang.String group,
                                                 int klass)

Return names from a specific group as String object stored as a Vector object

isNameInGroup

public static boolean isNameInGroup(java.lang.String name,
                                    java.lang.String group)

getIDFromNameAndGroup

public static int getIDFromNameAndGroup(java.lang.String name,
                                        java.lang.String group)

getListOfStoredTones

public static java.util.Vector getListOfStoredTones()

playAllTones

public static void playAllTones()

playTonesByClass

public static void playTonesByClass(int klass)

listTones

public static void listTones(int klass)

displayState

public static void displayState()