1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 Copyright 2014 The Android Open Source Project
4
5 Licensed under the Apache License, Version 2.0 (the "License");
6 you may not use this file except in compliance with the License.
7 You may obtain a copy of the License at
8
9     http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16-->
17
18<sample>
19    <name>BluetoothChat</name>
20    <group>Connectivity</group>
21    <package>com.example.android.bluetoothchat</package>
22
23    <!-- change minSdk if needed-->
24    <minSdk>14</minSdk>
25
26    <!-- Include additional dependencies here.-->
27    <!-- dependency>com.google.android.gms:play-services:5.0.+</dependency -->
28
29    <strings>
30        <intro>
31            <![CDATA[
32            This application allows two Android devices to carry out two-way text chat over
33            Bluetooth. It demonstrates all the fundamental Bluetooth API capabilites, such as:
34              (1) Scanning for other Bluetooth devices
35              (2) Querying the local Bluetooth adapter for paired Bluetooth devices
36              (3) Establishing RFCOMM channels/sockets
37              (4) Connecting to a remote device
38              (5) Transfering data over Bluetooth
39            ]]>
40        </intro>
41    </strings>
42
43    <!-- The basic templates have already been enabled. Uncomment more as desired. -->
44    <template src="base" />
45    <template src="FragmentView" />
46
47    <!-- Include common code modules by uncommenting them below. -->
48    <common src="logger" />
49    <common src="activities"/>
50
51    <metadata>
52        <status>PUBLISHED</status>
53        <categories>Connectivity</categories>
54        <technologies>Android</technologies>
55        <languages>Java</languages>
56        <solutions>Mobile</solutions>
57        <level>ADVANCED</level>
58        <icon>screenshots/icon-web.png</icon>
59        <screenshots>
60            <img>screenshots/1-launch.png</img>
61            <img>screenshots/2-devices.png</img>
62            <img>screenshots/3-chat.png</img>
63        </screenshots>
64        <api_refs>
65            <android>android.bluetooth.BluetoothAdapter</android>
66            <android>android.bluetooth.BluetoothDevice</android>
67            <android>android.bluetooth.BluetoothServerSocket</android>
68            <android>android.bluetooth.BluetoothSocket</android>
69        </api_refs>
70
71        <description>
72<![CDATA[
73This sample shows how to implement two-way text chat over Bluetooth between two Android devices, using
74all the fundamental Bluetooth API capabilities.
75]]>
76        </description>
77
78        <intro>
79<![CDATA[
80This sample should be run on two Android devices at the same time, to establish a two-way chat over
81Bluetooth between the devices. Select "Made discoverable" in overflow menu on one device and click
82on the Bluetooth icon on the other one, to find the device and establish the connection.
83
84The sample demonstrates the following, using the [Bluetooth API][1]:
85
861. [Setting up][2] Bluetooth
872. [Scanning][3] for other Bluetooth devices
883. [Querying][4] the local Bluetooth adapter for paired Bluetooth devices
894. [Establishing RFCOMM][5] channels/sockets
905. [Connecting][6] to a remote device
916. [Transfering][7] data over Bluetooth
92
93[1]: http://developer.android.com/guide/topics/connectivity/bluetooth.html
94[2]: http://developer.android.com/guide/topics/connectivity/bluetooth.html#Permissions
95[3]: http://developer.android.com/guide/topics/connectivity/bluetooth.html#FindingDevices
96[4]: http://developer.android.com/guide/topics/connectivity/bluetooth.html#QueryingPairedDevices
97[5]: http://developer.android.com/guide/topics/connectivity/bluetooth.html#ConnectingDevices
98[6]: http://developer.android.com/guide/topics/connectivity/bluetooth.html#ConnectingAsAClient
99[7]: http://developer.android.com/guide/topics/connectivity/bluetooth.html#ManagingAConnection
100]]>
101        </intro>
102    </metadata>
103
104
105</sample>
106