Bondi logo

Bondi Device Capabilities - Version 1.1 Candidate Release

26 October 2009

Authors:

Marcin Hanclik, ACCESS Co., Ltd. <marcin.hanclik@access-company.com>

Abstract

This section lists the Device Capabilities used by the BONDI APIs. For each Device Capability, parameters available to the Security Policy are listed.


Device Capabilities
Device CapabilityMeaningParameterMeaning
appconfig.setSets application configuration settingkeyconfiguration setting key
appconfig.getGets application configuration settingkeyconfiguration setting key
applauncher.launchLaunches an application stored in the phone terminalknownNameKnown name of application, from the list given after thistable. Empty bag if application being launched does not have a well Knownname. The Known application name is determined by the implementationfrom the information provided in the API.
appParamParameter to application; meaning dependent on knownName.
pathallow or deny to launch a given application path
applauncher.getGets the list of installed applications or the default one for a given mime typepath 
camera.accessRetrieving camera hardware devices available on the device  
camera.captureCapturing an image by using a camera hardware device  
camera.recordRecording a video by using a camera hardware device  
commlog.sms.getGet entries from SMS log  
commlog.mms.getGet entries from MMS log  
commlog.email.getGet entries from email log  
commlog.call.getGet entries from call log  
commlog.clearClear entries from a log  
devicestatus.getGet (or subscribe to) device status property valuevocabularyVocabulary IRI
componentComponent Identifier
aspectLocal Aspect Name
propertyLocal Property Name
devicestatus.setSet device status property valuevocabularyVocabulary IRI
componentComponent Identifier
aspectLocal Aspect Name
propertyLocal Property Name
devicestatus.listList available elements in the vocabularylevelOne of (vocabulary, aspect, component, property)
io.file.readRead directory or filenameName of directory or file, in virtual filesystem,e.g. rootlocation/filename
io.file.writeWrite directory or filenameName of directory or file, in virtual filesystem,e.g. rootlocation/filename
location.positionDetects the device current positionoriginOrigin of the data (e.g. network, gps, wifi). The origin is determined bythe implementation
messaging.email.attachAdd/change attachment on an email  
messaging.mms.attachAdd/change attachment on an MMS  
messaging.email.getAccountsGet email accounts  
messaging.email.sendSends an email messagerecipientsSpace-separated list of recipient email addresses.
inContactsyes or undefined value depending on whether allrecipients are in contacts list
messaging.mms.sendSends an mms messagerecipientsSpace-separated list of recipient phone numbers. Anyinternational phone number must start with a U+002B PLUS SIGN.
inContactsyes or undefined value depending on whether allrecipients are in contacts list
messaging.sms.sendSends an sms messagerecipientsSpace-separated list of recipient phone numbers. Anyinternational phone number must start with a U+002B PLUS SIGN.
inContactsyes or undefined value depending on whether allrecipients are in contacts list
messaging.binary.sendSends a binary messagerecipientsSpace-separated list of recipient phone numbers. Anyinternational phone number must start with a U+002B PLUS SIGN.
inContactsyes or undefined value depending on whether allrecipients are in contacts list
messaging.mms.subscribeSubscribe to mms message notificationssenderSender of the message
messaging.sms.subscribeSubscribe to sms message notificationssenderSender of the message
messaging.binary.subscribeSubscribe to email message notificationssenderSender of the message
io.file.readRead gallery files from the filesystem.nameName of directory or file, in virtual filesystem,e.g. rootlocation/filename
pim.contact.readRead the contacts stored in the terminal  
pim.contact.writeWrites contacts to be stored in the terminal  
pim.task.readRead tasks  
pim.task.readWrite, modify or delete tasks  
pim.event.writeWrites events into the terminal storage  
pim.event.readRead contacts from the terminal storage  
uiAccess to the user interaction capability  

The knownName parameter to the applauncher.launch device capability has one of these values:

Known Names
Known Name ValueMeaningAppParam Value
"browser"Browser application.URI initial URI, empty bag if none.
"email"Email sending application.String email address to send to.
"phone"Phone applicationString phone number (as in tel: URI).
"sms"SMS applicationString phone number (as in smsto: URI).
"mms"MMS applicationString phone number (as in mmsto: URI).
"mediaplayer"Media player application.URI initial URI, empty bag if none.
Empty bagAn application not recognised as one of the above.Empty bag.