ofono/doc/smartmessaging-api.txt

64 lines
1.9 KiB
Plaintext

Smart Messaging hierarchy
===============
Service org.ofono
Interface org.ofono.SmartMessaging
Object path [variable prefix]/{modem0,modem1,...}
Methods object SendAppointment(string to, array{bytes} appointment)
Sends a vCalendar object in appointment to the number
in to. The object in appointment is not interpreted
by oFono in any way. If the object is too large to
fit into a single SMS, it is fragmented as appropriate.
This method call returns the object path of the queued
SMS.
object SendBusinessCard(string to, array{bytes} card)
Sends a vCard object in card to the number in to. The
object in card is not interpreted by oFono in any way.
If the object is too large to fit into a single SMS,
it is fragmented as appropriate. This method call
returns the object path of the queued SMS.
void RegisterAgent(object path)
Registers an agent which will be called whenever a
new Smart Messaging based SMS arrives.
void UnregisterAgent(object path)
Unregisters an agent.
SmartMessagingAgent Hierarchy [experimental]
===============
Service unique name
Interface org.ofono.SmartMessagingAgent
Object path freely definable
Methods void ReceiveAppointment(array{byte} appointment, dict info)
Requests the agent to process a new SMS that has
arrived containing a vCalendar object. The info
dictionary contains 'Sender', 'LocalSentTime' and
'SentTime' properties.
Possible Errors: None
void ReceiveBusinessCard(array{byte} card, dict info)
Requests the agent to process a new SMS that has
arrived containing a vCard object. The info
dictionary contains 'Sender', 'LocalSentTime' and
'SentTime' properties.
Possible Errors: None
void Release() [noreply]
Agent is being released, possibly because of oFono
terminating, SMS interface is being torn down or modem
off. No UnregisterAgent call is needed.