summaryrefslogtreecommitdiffstats
path: root/doc/pushnotification-api.txt
blob: 942ba0f144436ea2b566a9224b6395bee627eb9b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
Push Notification hierarchy
===============

Service		org.ofono
Interface	org.ofono.PushNotification
Object path	[variable prefix]/{modem0,modem1,...}

Methods		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.

PushNotificationAgent Hierarchy [experimental]
===============

Service		unique name
Interface	org.ofono.PushNotificationAgent
Object path	freely definable

Methods		void ReceiveNotification(array{byte} notification, dict info)

			Requests the agent to process a new SMS that has
			arrived containing a WAP PUSH.  The dictionary
			info 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.