目录
一，背景介绍
二，技术方案
2.1 获取BluetoothHidDevice实例
2.2 注册/解除注册HID实例
2.3 Hid report description描述符生成工具
2.4 键盘映射表
2.5 通过HID发送键盘事件
三，实例
一，背景介绍
日常生活中，各种物理遥控器和鼠标等设备，需要摆放和携带，便捷性有待考验。根据蓝牙HID特性，可以用蓝牙协议模仿键盘，来实现空中键盘等功能。
二，技术方案
自Android 9开放BluetoothHidDevice功能后，Android平台可以很简单的通过BluetoothHidDevice模拟键盘鼠标等蓝牙hid device角色。
2.1 获取BluetoothHidDevice实例
BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
bluetoothAdapter.setName("KEYBOARD BT");
bluetoothAdapter.getProfileProxy(context,mProfileServiceListener,BluetoothProfile.HID_DEVICE);2.2 注册/解除注册HID实例
public static BluetoothProfile.ServiceListener mProfileServiceListener = new BluetoothProfile.ServiceListener() {
@Override
public void onServiceDisconnected(int profile) {
Log.e(TAG, "hid onServiceDisconnected");
if (profile == BluetoothProfile.HID_DEVICE) {
mHidDevice.unregisterApp();
}
}
@SuppressLint("NewApi")
@Override
public void onServiceConnected(int profile, BluetoothProfile proxy) {
Log.e(TAG, "hid onServiceConnected");
bluetoothProfile = proxy;
if (profile == BluetoothProfile.HID_DEVICE) {
mHidDevice = (BluetoothHidDevice) proxy;
HidConsts.HidDevice = mHidDevice;
BluetoothHidDeviceAppSdpSettings sdp = new BluetoothHidDeviceAppSdpSettings(HidConsts.NAME, HidConsts.DESCRIPTION, HidConsts.PROVIDER, BluetoothHidDevice.SUBCLASS1_COMBO, HidConsts.Descriptor);
mHidDevice.registerApp(sdp, null, null, Executors.newCachedThreadPool(), mCallback);
}
}
};
在获取到BluetoothHidDevice实例后通过registerApp注册hid device，此时hid host角色会被禁用，因此在不需要hid device功能时要及时解除hid device的注册。
registerApp函数中最重要的一个参数BluetoothHidDeviceAppSdpSettings，主要是给对端host提供hid device角色的名称，描述信息，供应商信息，以及Hid device的Reports Descriptor。
2.3 Hid report description描述符生成工具
参考文章《官网HID描述符工具》
val Descriptor = byteArrayOf(
0x05.toByte(),
0x01.toByte(),
0x09.toByte(),
0x02.toByte(),
0xa1.toByte(),
0x01.toByte(),
0x09.toByte(),
0x01.toByte(),
0xa1.toByte(),
0x00.toByte(),
0x85.toByte(),
0x01.toByte(),
0x05.toByte(),
0x09.toByte(),
0x19.toByte(),
0x01.toByte(),
0x29.toByte(),
0x03.toByte(),
0x15.toByte(),
0x00.toByte(),
0x25.toByte(),
0x01.toByte(),
0x95.toByte(),
0x03.toByte(),
0x75.toByte(),
0x01.toByte(),
0x81.toByte(),
0x02.toByte(),
0x95.toByte(),
0x01.toByte(),
0x75.toByte(),
0x05.toByte(),
0x81.toByte(),
0x03.toByte(),
0x05.toByte(),
0x01.toByte(),
0x09.toByte(),
0x30.toByte(),
0x09.toByte(),
0x31.toByte(),
0x09.toByte(),
0x38.toByte(),
0x15.toByte(),
0x81.toByte(),
0x25.toByte(),
0x7f.toByte(),
0x75.toByte(),
0x08.toByte(),
0x95.toByte(),
0x03.toByte(),
0x81.toByte(),
0x06.toByte(),
0xc0.toByte(),
0xc0.toByte(),
0x05.toByte(),
0x01.toByte(),
0x09.toByte(),
0x06.toByte(),
0xa1.toByte(),
0x01.toByte(),
0x85.toByte(),
0x02.toByte(),
0x05.toByte(),
0x07.toByte(),
0x19.toByte(),
0xE0.toByte(),
0x29.toByte(),
0xE7.toByte(),
0x15.toByte(),
0x00.toByte(),
0x25.toByte(),
0x01.toByte(),
0x75.toByte(),
0x01.toByte(),
0x95.toByte(),
0x08.toByte(),
0x81.toByte(),
0x02.toByte(),
0x95.toByte(),
0x01.toByte(),
0x75.toByte(),
0x08.toByte(),
0x15.toByte(),
0x00.toByte(),
0x25.toByte(),
0x65.toByte(),
0x19.toByte(),
0x00.toByte(),
0x29.toByte(),
0x65.toByte(),
0x81.toByte(),
0x00.toByte(),
0x05.toByte(),
0x08.toByte(),
0x95.toByte(),
0x05.toByte(),
0x75.toByte(),
0x01.toByte(),
0x19.toByte(),
0x01.toByte(),
0x29.toByte(),
0x05.toByte(),
0x91.toByte(),
0x02.toByte(),
0x95.toByte(),
0x01.toByte(),
0x75.toByte(),
0x03.toByte(),
0x91.toByte(),
0x03.toByte(),
0xc0.toByte()
)
2.4 键盘映射表
<string name="KeyText1" translatable="false">Esc</string>
<string name="KeyCode1" translatable="false">29</string> <!-- Keyboard ESCAPE -->
<string name="KeyText2" translatable="false">F1</string>
<string name="KeyCode2" translatable="false">3a</string> <!-- Keyboard F1 -->
<string name="KeyText3" translatable="false">F2</string>
<string name="KeyCode3" translatable="false">3b</string> <!-- Keyboard F2 -->
<string name="KeyText4" translatable="false">F3</string>
<string name="KeyCode4" translatable="false">3c</string> <!-- Keyboard F3 -->
<string name="KeyText5" translatable="false">F4</string>
<string name="KeyCode5" translatable="false">3d</string> <!-- Keyboard F4 -->
<string name="KeyText6" translatable="false">F5</string>
<string name="KeyCode6" translatable="false">3e</string> <!-- Keyboard F5 -->
<string name="KeyText7" translatable="false">F6</string>
<string name="KeyCode7" translatable="false">3f</string> <!-- Keyboard F6 -->
<string name="KeyText8" translatable="false">F7</string>
<string name="KeyCode8" translatable="false">40</string> <!-- Keyboard F7 -->
<string name="KeyText9" translatable="false">F8</string>
<string name="KeyCode9" translatable="false">41</string> <!-- Keyboard F8 -->
<string name="KeyText10" translatable="false">F9</string>
<string name="KeyCode10" translatable="false">42</string> <!-- Keyboard F9 -->
<string name="KeyText11" translatable="false">F10</string>
<string name="KeyCode11" translatable="false">43</string> <!-- Keyboard F10 -->
<string name="KeyText12" translatable="false">F11</string>
<string name="KeyCode12" translatable="false">44</string> <!-- Keyboard F11 -->
<string name="KeyText13" translatable="false">F12</string>
<string name="KeyCode13" translatable="false">45</string> <!-- Keyboard F12 -->
<string name="KeyText14" translatable="false">`  ~</string>
<string name="KeyCode14" translatable="false">35</string> <!-- Keyboard ` and ~ -->
<string name="KeyText15" translatable="false">1  !</string>
<string name="KeyCode15" translatable="false">1e</string> <!-- Keyboard 1 and ! -->
<string name="KeyText16" translatable="false">2  @</string>
<string name="KeyCode16" translatable="false">1f</string> <!-- Keyboard 2 and @ -->
<string name="KeyText17" translatable="false">3  #</string>
<string name="KeyCode17" translatable="false">20</string> <!-- Keyboard 3 and # -->
<string name="KeyText18" translatable="false">4  $</string>
<string name="KeyCode18" translatable="false">21</string> <!-- Keyboard 4 and $ -->
<string name="KeyText19" translatable="false">5  %</string>
<string name="KeyCode19" translatable="false">22</string> <!-- Keyboard 5 and % -->
<string name="KeyText20" translatable="false">6  ^</string>
<string name="KeyCode20" translatable="false">23</string> <!-- Keyboard 6 and ^ -->
<string name="KeyText21" translatable="false">7  &</string>
<string name="KeyCode21" translatable="false">24</string> <!-- Keyboard 7 and & -->
<string name="KeyText22" translatable="false">8  *</string>
<string name="KeyCode22" translatable="false">25</string> <!-- Keyboard 8 and * -->
<string name="KeyText23" translatable="false">9  (</string>
<string name="KeyCode23" translatable="false">26</string> <!-- Keyboard 9 and ( -->
<string name="KeyText24" translatable="false">0  )</string>
<string name="KeyCode24" translatable="false">27</string> <!-- Keyboard 0 and ) -->
<string name="KeyText25" translatable="false">-  _</string>
<string name="KeyCode25" translatable="false">2d</string> <!-- Keyboard - and _ -->
<string name="KeyText26" translatable="false">=  +</string>
<string name="KeyCode26" translatable="false">2e</string> <!-- Keyboard = and + -->
<string name="KeyText27" translatable="false">Backspace</string>
<string name="KeyCode27" translatable="false">2a</string> <!-- Keyboard DELETE (Backspace) -->
<string name="KeyText28" translatable="false">Tab</string>
<string name="KeyCode28" translatable="false">2b</string> <!-- Keyboard Tab -->
<string name="KeyText29" translatable="false">Q</string>
<string name="KeyCode29" translatable="false">14</string> <!-- Keyboard q and Q -->
<string name="KeyText30" translatable="false">W</string>
<string name="KeyCode30" translatable="false">1a</string> <!-- Keyboard w and W -->
<string name="KeyText31" translatable="false">E</string>
<string name="KeyCode31" translatable="false">08</string> <!-- Keyboard e and E -->
<string name="KeyText32" translatable="false">R</string>
<string name="KeyCode32" translatable="false">15</string> <!-- Keyboard r and R -->
<string name="KeyText33" translatable="false">T</string>
<string name="KeyCode33" translatable="false">17</string> <!-- Keyboard t and T -->
<string name="KeyText34" translatable="false">Y</string>
<string name="KeyCode34" translatable="false">1c</string> <!-- Keyboard y and Y -->
<string name="KeyText35" translatable="false">U</string>
<string name="KeyCode35" translatable="false">18</string> <!-- Keyboard u and U -->
<string name="KeyText36" translatable="false">I</string>
<string name="KeyCode36" translatable="false">0c</string> <!-- Keyboard i and I -->
<string name="KeyText37" translatable="false">O</string>
<string name="KeyCode37" translatable="false">12</string> <!-- Keyboard o and O -->
<string name="KeyText38" translatable="false">P</string>
<string name="KeyCode38" translatable="false">13</string> <!-- Keyboard p and P -->
<string name="KeyText39" translatable="false">[  {</string>
<string name="KeyCode39" translatable="false">2f</string> <!-- Keyboard [ and { -->
<string name="KeyText40" translatable="false">]  }</string>
<string name="KeyCode40" translatable="false">30</string> <!-- Keyboard ] and } -->
<string name="KeyText41" translatable="false">\\  |</string>
<string name="KeyCode41" translatable="false">31</string> <!-- Keyboard \ and | -->
<string name="KeyText42" translatable="false">CapsLock</string>
<string name="KeyCode42" translatable="false">39</string> <!-- Keyboard Caps Lock -->
<string name="KeyText43" translatable="false">A</string>
<string name="KeyCode43" translatable="false">04</string> <!-- Keyboard a and A -->
<string name="KeyText44" translatable="false">S</string>
<string name="KeyCode44" translatable="false">16</string> <!-- Keyboard s and S -->
<string name="KeyText45" translatable="false">D</string>
<string name="KeyCode45" translatable="false">07</string> <!-- Keyboard d and D -->
<string name="KeyText46" translatable="false">F</string>
<string name="KeyCode46" translatable="false">09</string> <!-- Keyboard f and F -->
<string name="KeyText47" translatable="false">G</string>
<string name="KeyCode47" translatable="false">0a</string> <!-- Keyboard g and G -->
<string name="KeyText48" translatable="false">H</string>
<string name="KeyCode48" translatable="false">0b</string> <!-- Keyboard h and H -->
<string name="KeyText49" translatable="false">J</string>
<string name="KeyCode49" translatable="false">0d</string> <!-- Keyboard j and J -->
<string name="KeyText50" translatable="false">K</string>
<string name="KeyCode50" translatable="false">0e</string> <!-- Keyboard k and K -->
<string name="KeyText51" translatable="false">L</string>
<string name="KeyCode51" translatable="false">0f</string> <!-- Keyboard l and L -->
<string name="KeyText52" translatable="false">;  :</string>
<string name="KeyCode52" translatable="false">33</string> <!-- Keyboard ; and : -->
<string name="KeyText53" translatable="false">\'  \"</string>
<string name="KeyCode53" translatable="false">34</string> <!-- Keyboard ' and " -->
<string name="KeyText54" translatable="false">Enter</string>
<string name="KeyCode54" translatable="false">28</string> <!-- Keyboard Return (ENTER) -->
<string name="KeyText55" translatable="false">Shift</string>
<string name="KeyCode55" translatable="false">02</string> <!-- Keyboard Left Shift -->
<string name="KeyText56" translatable="false">Z</string>
<string name="KeyCode56" translatable="false">1d</string> <!-- Keyboard z and Z -->
<string name="KeyText57" translatable="false">X</string>
<string name="KeyCode57" translatable="false">1b</string> <!-- Keyboard x and X -->
<string name="KeyText58" translatable="false">C</string>
<string name="KeyCode58" translatable="false">06</string> <!-- Keyboard c and C -->
<string name="KeyText59" translatable="false">V</string>
<string name="KeyCode59" translatable="false">19</string> <!-- Keyboard v and V -->
<string name="KeyText60" translatable="false">B</string>
<string name="KeyCode60" translatable="false">05</string> <!-- Keyboard b and B -->
<string name="KeyText61" translatable="false">N</string>
<string name="KeyCode61" translatable="false">11</string> <!-- Keyboard n and N -->
<string name="KeyText62" translatable="false">M</string>
<string name="KeyCode62" translatable="false">10</string> <!-- Keyboard m and M -->
<string name="KeyText63" translatable="false">,  <</string>
<string name="KeyCode63" translatable="false">36</string> <!-- Keyboard , and < -->
<string name="KeyText64" translatable="false">.  ></string>
<string name="KeyCode64" translatable="false">37</string> <!-- Keyboard . and > -->
<string name="KeyText65" translatable="false">/  ?</string>
<string name="KeyCode65" translatable="false">38</string> <!-- Keyboard / and ? -->
<string name="KeyText66" translatable="false">Shift</string>
<string name="KeyCode66" translatable="false">20</string> <!-- Keyboard Right Shift -->
<string name="KeyText67" translatable="false">Ctrl</string>
<string name="KeyCode67" translatable="false">01</string> <!-- Keyboard Left Ctrl -->
<string name="KeyText68" translatable="false">⊞</string>
<string name="KeyCode68" translatable="false">08</string> <!-- Keyboard Left Win -->
<string name="KeyText69" translatable="false">Alt</string>
<string name="KeyCode69" translatable="false">04</string> <!-- Keyboard Left Alt -->
<string name="KeyText70" translatable="false">SPACE</string>
<string name="KeyCode70" translatable="false">2c</string> <!-- Keyboard Space -->
<string name="KeyText71" translatable="false">Alt</string>
<string name="KeyCode71" translatable="false">40</string> <!-- Keyboard Right Alt -->
<string name="KeyText72" translatable="false">Win</string>
<string name="KeyCode72" translatable="false">80</string> <!-- Keyboard Right Win -->
<string name="KeyText73" translatable="false">☰</string>
<string name="KeyCode73" translatable="false">65</string> <!-- Keyboard Application -->
<string name="KeyText74" translatable="false">Ctrl</string>
<string name="KeyCode74" translatable="false">10</string> <!-- Keyboard Right Ctrl -->
<string name="KeyText75" translatable="false">Print Screen</string>
<string name="KeyCode75" translatable="false">46</string> <!-- Keyboard Print Screen -->
<string name="KeyText76" translatable="false">Scroll Lock</string>
<string name="KeyCode76" translatable="false">47</string> <!-- Keyboard Scroll Lock -->
<string name="KeyText77" translatable="false">PAUSE</string>
<string name="KeyCode77" translatable="false">48</string> <!-- Keyboard Pause -->
<string name="KeyText78" translatable="false">Insert</string>
<string name="KeyCode78" translatable="false">49</string> <!-- Keyboard Insert -->
<string name="KeyText79" translatable="false">Home</string>
<string name="KeyCode79" translatable="false">4a</string> <!-- Keyboard Home -->
<string name="KeyText80" translatable="false">PgUp</string>
<string name="KeyCode80" translatable="false">4b</string> <!-- Keyboard Page Up -->
<string name="KeyText81" translatable="false">Delete</string>
<string name="KeyCode81" translatable="false">4c</string> <!-- Keyboard Delete Forward -->
<string name="KeyText82" translatable="false">End</string>
<string name="KeyCode82" translatable="false">4d</string> <!-- Keyboard End -->
<string name="KeyText83" translatable="false">PgDn</string>
<string name="KeyCode83" translatable="false">4e</string> <!-- Keyboard Page Down -->
<string name="KeyText84" translatable="false">▲</string>
<string name="KeyCode84" translatable="false">52</string> <!-- Keyboard Up Arrow -->
<string name="KeyText85" translatable="false">◀</string>
<string name="KeyCode85" translatable="false">50</string> <!-- Keyboard Left Arrow -->
<string name="KeyText86" translatable="false">▼</string>
<string name="KeyCode86" translatable="false">51</string> <!-- Keyboard Down Arrow -->
<string name="KeyText87" translatable="false">▶</string>
<string name="KeyCode87" translatable="false">4f</string> <!-- Keyboard Right Arrow -->2.5 通过HID发送键盘事件
通过HID设备，发送report，
HidDevice!!.sendReport(HidUtils.mDevice, report.ReportId.toInt(), report.ReportData)
三，实例
需要源码，请私信
