Android Bluetooth opp package 学习笔记.doc

Android Bluetooth opp package 学习笔记一、 背景及相关知识学习1、Android Bluetooth SDK首先，要操作蓝牙，先要在AndroidManifest.xml里加入权限。我们可以通过intent调用android.bluetooth.opp包下的activity也可以直接调用android.bluetooth包使用android的蓝牙功能。 方法如下：通过android.bluetooth.opp包我们需要作的是：打开蓝牙：Intemt enabler=newIntent(BluetoothAdapter.ACTION_REQUEST_ENABLE);startActivityForResult(enabler,reCode);/同startActivity(enabler);通过android.bluetooth包我们需要做的是以下几点：1.BluetoothAdapter 顾名思义，蓝牙适配器，直到我们建立bluetoothSocket连接之前，都要不断操作它BluetoothAdapter里的方法很多，常用的有以下几个：cancelDiscovery() 根据字面意思，是取消发现，也就是说当我们正在搜索设备的时候调用这个方法将不再继续搜索disable()关闭蓝牙enable()打开蓝牙getAddress()获取本地蓝牙地址getDefaultAdapter()获取默认BluetoothAdapter，实际上，也只有这一种方法获取BluetoothAdaptergetName()获取本地蓝牙名称getRemoteDevice(String address)根据蓝牙地址获取远程蓝牙设备getState()获取本地蓝牙适配器当前状态（感觉可能调试的时候更需要）isDiscovering()判断当前是否正在查找设备，是返回trueisEnabled()判断蓝牙是否打开，已打开返回true，否则，返回falselistenUsingRfcommWithServiceRecord(String name,UUID uuid)根据名称，UUID创建并返回BluetoothServerSocket，这是创建BluetoothSocket服务器端的第一步startDiscovery()开始搜索，这是搜索的第一步2.BluetoothDevice看名字就知道，这个类描述了一个蓝牙设备createRfcommSocketToServiceRecord(UUID uuid)根据UUID创建并返回一个BluetoothSocket这个方法也是我们获取BluetoothDevice的目的创建BluetoothSocket这个类其他的方法，如getAddress(),getName(),同BluetoothAdapter3.BluetoothServerSocket如果去除了Bluetooth相信大家一定再熟悉不过了，既然是Socket，方法就应该都差不多，这个类一种只有三个方法两个重载的accept(),accept(int timeout)两者的区别在于后面的方法指定了过时时间，需要注意的是，执行这两个方法的时候，直到接收到了客户端的请求（或是过期之后），都会阻塞线程，应该放在新线程里运行！还有一点需要注意的是，这两个方法都返回一个BluetoothSocket，最后的连接也是服务器端与客户端的两个BluetoothSocket的连接，close()关闭！4.BluetoothSocket,跟BluetoothServerSocket相对，是客户端 一共5个方法，不出意外，都会用到 close(),关闭 connect()连接 getInptuStream()获取输入流 getOutputStream()获取输出流 getRemoteDevice()获取远程设备，这里指的是获取bluetoothSocket指定连接的那个远程蓝牙设备2、Android Bluetooth 底层知识Android蓝牙协议栈使用的是BlueZ，支持GAP, SDP, and RFCOMM规范，是一个SIG认证的蓝牙协议栈。Bluez 是GPL许可的，因此Android的框架内与用户空间的bluez代码通过D-BUS进程通讯进行交互，以避免专有代码。Headset和Handsfree(v1.5)规范就在Android框架中实现的，它是跟Phone App紧密耦合的。这些规范也是SIG认证的。下面的图表提供了一个以库为导向的蓝牙栈视图。实线框的是Android模块，红色虚线部分为合作伙伴指定模块（译者注：芯片商提供）。下面的图表是以进程为导向视图：移植BlueZ是兼容蓝牙2.1的，可以工作在任何2.1芯片以及向后兼容的旧的蓝牙版本。有要有两个方面：串口驱动 UART driver 蓝牙电源开/关 Bluetooth Power On/Off 串口驱动BlueZ核心子系统使用hciattach守护进程添加你的指定硬件串口驱动。例如，MSM7201A，这个文件是在drivers/serial/msm_serial.c。你还需要通过修改init.rc为hciattach来编辑命令行选项。蓝牙电源开/关蓝牙芯片的电源开关方法1.0和Post 1.0是不同的，具体如下：1.0：Android框架写0或1到/sys/modules/board_PLATFORM/parameters/bluetooth_power_on Post 1.0：Android框架使用linux rfkill API，参考 arch/arm/mach-msm/board-trout-rfkill.c例子。 编译编译Android打开蓝牙支持，添加下面这行内容到BoardConfig.mk。 BOARD_HAVE_BLUETOOTH :=true调试调试你的蓝牙实现，可以通过读跟蓝牙相关的logs(adb logcat)和查找ERROR和警告消息。Android使用Bluez，同时会带来一些有用的调式工具。下面的片段为了提供一个建议的例子： view source print ? 1 hciconfig -a # print BT chipset address and features. Useful to check if you can communicate with your BT chipset. 2 hcidump -XVt # print live HCI UART traffic. 3 hcitool scan # scan for local devices. Useful to check if RX/TX works. 4 l2ping ADDRESS # ping another BT device. Useful to check if RX/TX works. 5 sdptool records ADDRESS # request the SDP records of another BT device. 守护进程日志hcid(STDOUT)和hciattach(STDERR)的守护进程日志缺省是被写到/dev/null。编辑init.rc和init.PLATFORM.rc在logwrapper下运行这些守护进程，把它们输出到logcat。hciconfig -a 和 hcitool如果你编译你自己的system.img，除了hcitool扫描不行，hciconfig -a是可以工作的，尝试安装固件到蓝牙芯片。XXX TBD工具BlueZ为调试和与蓝牙子系统通信提供很多设置命令行工具，包含下面这些：Hciconfig、hcitool、hcidump、sdptool、dbus-send、dbus-monitor二、 主要类的学习1、 BluetoothOppProvider 继承ContentProvider，所谓ContentProvider是一个提供数据的机制，当希望对其它app提供数据时需要用到。BluetoothOppProvider提供了蓝牙设置相关的数据。其中的数据表位btopp，其数据项包括BluetoothShare._ID、BluetoothShare.URI、 BluetoothShare.FILENAME_HINT、BluetoothShare._DATA、BluetoothShare.MIMETYPE 、BluetoothShare.DIRECTION、BluetoothShare.DESTINATION、BluetoothShare.VISIBILITY、BluetoothShare.USER_CONFIRMATION 、BluetoothShare.STATUS、 BluetoothShare.TOTAL_BYTES、BluetoothShare.CURRENT_BYTES、BluetoothShare.TIMESTAMP、Constants.MEDIA_SCANNED为字段名的数据项。2、 BluetoothOppReceiver继承BroadcastReceiver，所谓BroadcastReceiver是一个能够接受以sendBroadcast()方式发送的intent的基类。BluetoothOppReceiver处理系统消息：Intent.ACTION_BOOT_COMPLETED、BluetoothAdapter.ACTION_STATE_CHANGED；其它app发来的消息：BluetoothDevicePicker.ACTION_DEVICE_SELECTED、Constants.ACTION_INCOMING_FILE_CONFIRM；opp service发来的消息：BluetoothShare.INCOMING_FILE_CONFIRMATION_REQUEST_ACTION、BluetoothShare.TRANSFER_COMPLETED_ACTION；应用层发来的消息：Constants.ACTION_OPEN、Constants.ACTION_LIST、Constants.ACTION_OPEN_OUTBOUND_TRANSFER、Constants.ACTION_OPEN_INBOUND_TRANSFER、Constants.ACTION_HIDE、Constants.ACTION_COMPLETE_HIDE。3、 BluetoothOppService继承Service，所谓Service是一个能在系统后台工作，向其他app提供服务的机制。每个Service都需要在AndroidManifest.xml上声明。BluetoothOppService提供蓝牙的后台服务，包括文件传输和消息侦听。4、 BluetoothOppTransfer为BluetoothOppService提供对象传输客户端功能，调用BluetoothOppObexClientSession维护传输会话。5、 BluetoothOppRfcommListener 创建进程在OPUSH（OBEX Object Push） Chanel侦听socket消息，并回调BluetoothOppService中的回调函数进行处理。6、 BluetoothOppRfcommTransport 利用socket实现传输过程，只是封装来一下，并无实质内容。7、 BluetoothOppObexServerSession为BluetoothOppService提供对象传输服务器端功能。8、 BluetoothOppObexClientSession为BluetoothOppService提供对象传输客户端功能。三、总结android.bluetooth.opp包的结构大体如下图分层，其中UI交互层的类主要负责界面显示，用户交互等功能，特别还有其它app通过intent调用bluetooth应用的入口；事务逻辑层主要负责蓝牙应用层事务逻辑（BluetoothOppManager等）和数据抽象处理（BluetoothOppReceiveFileInfo）的功能；服务提供层主要提供对底层功能的封装调用（BluetoothOppProvider）和工具函数与常量（BluetoothOppUtility）。至于双模开发，要修改的文件应该没有。UserOther appBluetoothOppBtEnablingActivityBluetoothOppBtErrorActivity BluetoothOppNotificationBluetoothOppTransferHistoryBluetoothOppTransferActivityBluetoothOppTransferAdapterBluetoothOppIncomingFileConfirmActivityBluetoothOppBtEnableActivity.javaBluetoothOppLauncherActivity BluetoothOppLiveFolderUI交互BluetoothOppManagerBluetoothOppObexServerSessionBluetoothOppObexClientSessionBluetoothOppPreferenceBluetoothOppBatchBlu