aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: f84bccca2be6da7a68cd3acd0f6445d769259ed2 (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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
# 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>
{
  "bmessage":
    "BEGIN:BMSG\r\n
     VERSION:1.0\r\n
     STATUS:UNREAD\r\n
     TYPE:SMS_GSM\r\n
     FOLDER:telecom/msg/inbox\r\n
     NOTIFICATION:1\r\n
     BEGIN:VCARD\r\n
     VERSION:2.1\r\n
     FN;CHARSET=UTF-8:Satoshi Nakamoto\r\n
     N;CHARSET=UTF-8:Satoshi\r\n
     TEL:+13605551212\r\n
     END:VCARD\r\n
     BEGIN:BENV\r\n
     BEGIN:BBODY\r\n
     CHARSET:UTF-8\r\n
     LANGUAGE:UNKNOWN\r\n
     LENGTH:46\r\n
     BEGIN:MSG\r\n
     Meet at Victor 23 at 6p?\r\n
     END:MSG\r\n
     END:BBODY\r\n
     END:BENV\r\n
     END:BMSG\r\n
    "
}
</pre>