aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 66d92be5fd310325522279f9d9d33e6141ad2153 (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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# Bluetooth MAP (Message Service Profile) Service

## Overview

Bluetooth MAP (Message Access Profile) service uses the respective profile support from BlueZ
to enable message notifications from SMS/email/etc.

### Important Notes

Message composition isn't available on iOS devices due to respective security polices, and in
turn isn't supported in Apple's implementation of the (MAP) Message Access Profile.

## Verbs

| Name              | Description                              | JSON Response                             |
|-------------------|------------------------------------------|-------------------------------------------|
| compose           | send message                             | see **compose verb** section              |
| subscribe         | subscribe to MAP service events          | *Request:* {"value": "notification"}      |
| unsubscribe       | unsubscribe to MAP service events        | *Request:* {"value": "notification"}      |

## Events

| Name              | Description                              | JSON Event Data                           |
|-------------------|------------------------------------------|-------------------------------------------|
| notification      | report notification message              | see **notification event** section        |


### compose verb

Send a message (if supported) via MAP profile:

<pre>
{
  "bmessage":
    "BEGIN:BMSG\r\n
     VERSION:1.0\r\n
     TYPE:SMS_GSM\r\n
     FOLDER:telecom/msg/outbox\r\n
     BEGIN:BENV\r\n
     BEGIN:VCARD\r\n
     VERSION:2.1\r\n
     TEL:+13605551212\r\n
     END:VCARD\r\n
     BEGIN:BBODY\r\n
     CHARSET:UTF-8\r\n
     LANGUAGE:UNKNOWN\r\n
     LENGTH:48\r\n
     BEGIN:MSG\r\n
     Sounds good. See you then.\r\n
     END:MSG\r\n
     END:BBODY\r\n
     END:BENV\r\n
     END:BMSG\r\n
    "
}
</pre>

### notification event

<pre>
{
   "status": "UNREAD",
   "type": "SMS_GSM",
   "folder": "telecom/msg/inbox",
   "recipient": {
       "fn": "Satoshi Nakamoto",
       "n": "Satoshi"
    },
    "message": "Meet at Victor 23 at 6p?"
}
</pre>