鸿蒙开发往期必看:
一分钟了解”纯血版!鸿蒙HarmonyOS Next应用开发!
“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线!(从零基础入门到精通)
“一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径!
简介
SPP是Serial Port Profile(串口协议)的缩写,是一种蓝牙协议,用于在蓝牙设备之间建立串行通信连接。通过SPP,蓝牙设备可以像使用串口一样进行数据传输,例如传输文件、文本等。
场景介绍
主要场景有:
- 服务端向客户端写入数据。
- 通过socket连接对端设备。
接口说明
完整的 JS API 说明以及实例代码请参考:SPP 接口。
具体接口说明如下表。
接口名 | 功能描述 |
---|---|
sppListen() | 创建一个服务端监听Socket。 |
sppAccept() | 服务端监听socket等待客户端连接。 |
sppConnect() | 客户端向远端设备发起spp连接。 |
sppCloseServerSocket() | 关闭服务端监听Socket。 |
sppCloseClientSocket() | 关闭客户端socket。 |
sppWrite() | 通过socket向远端发送数据。 |
on(type: 'sppRead') | 订阅spp读请求事件。 |
off(type: 'sppRead') | 取消订阅spp读请求事件。 |
主要场景开发步骤
服务端向客户端写入数据
-
import需要的socket模块。
-
需要SystemCapability.Communication.Bluetooth.Core系统能力。
-
开启设备蓝牙。
-
创建服务端socket,返回serverId。
-
服务端等待客户端连接,返回clientId。
-
服务端向客户端写入数据。
-
(可选)服务端订阅客户端写入的数据。
-
注销服务端socket。
-
注销客户端socket。
-
示例代码:
import { socket } from '@kit.ConnectivityKit'; import { AsyncCallback, BusinessError } from '@kit.BasicServicesKit'; // 创建服务器监听Socket, 返回serverId let serverNumber = -1; let sppOption: socket.SppOptions = { uuid: '00001101-0000-1000-8000-00805f9b34fb', secure: true, type: 0 }; socket.sppListen('server1', sppOption, (code, serverSocketID) => { if (code != null) { console.error('sppListen error, code is ' + (code as BusinessError).code); return; } else { serverNumber = serverSocketID; console.info('sppListen success, serverNumber = ' + serverNumber); } }); // socket等待客户端连接,连接成功返回clientId let clientNumber = -1; socket.sppAccept(serverNumber, (code, clientSocketID) => { if (code != null) { console.error('sppAccept error, code is ' + (code as BusinessError).code); return; } else { clientNumber = clientSocketID; console.info('accept the client success'); } }) console.info('waiting for client connection'); // 向客户端写入数据 let array = new Uint8Array(990); array[0] = 'A'.charCodeAt(0); array[1] = 'B'.charCodeAt(0); array[2] = 'C'.charCodeAt(0); array[3] = 'D'.charCodeAt(0); socket.sppWrite(clientNumber, array.buffer); console.info('sppWrite success'); // 订阅读请求事件 socket.on('sppRead', clientNumber, (dataBuffer: ArrayBuffer) => { const data = new Uint8Array(dataBuffer); if (data != null) { console.info('sppRead success, data = ' + JSON.stringify(data)); } else { console.error('sppRead error, data is null'); } }); // 取消订阅读请求事件 socket.off('sppRead', clientNumber, (dataBuffer: ArrayBuffer) => { const data = new Uint8Array(dataBuffer); if (data != null) { console.info('offSppRead success, data = ' + JSON.stringify(data)); } else { console.error('offSppRead error, data is null'); } }); // 注销服务端socket socket.sppCloseServerSocket(serverNumber); console.info('sppCloseServerSocket success'); // 注销客户端socket socket.sppCloseClientSocket(clientNumber); console.info('sppCloseClientSocket success');
-
错误码请参见蓝牙服务子系统错误码。
通过socket连接对端设备
-
import需要的socket模块。
-
需要SystemCapability.Communication.Bluetooth.Core系统能力。
-
开启设备蓝牙。
-
开启ble扫描,获取对端设备mac地址。
-
连接对端设备。
-
示例代码:
import { socket } from '@kit.ConnectivityKit'; import { AsyncCallback, BusinessError } from '@kit.BasicServicesKit'; // 开启ble扫描,获取对端设备mac地址 let deviceId = 'xx:xx:xx:xx:xx:xx'; // 连接对端设备 socket.sppConnect(deviceId, { uuid: '00001101-0000-1000-8000-00805f9b34fb', secure: true, type: 0 }, (code, socketID) => { if (code != null) { console.error('sppConnect error, code = ' + (code as BusinessError).code); return; } console.info('sppConnect success, socketId = ' + socketID); })
-
错误码请参见蓝牙服务子系统错误码。
最后
小编在之前的鸿蒙系统扫盲中,我明显感觉到一点,那就是许多人参与鸿蒙开发,但是又不知道从哪里下手,有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)路线图、文档、视频、用来跟着学习是非常有必要的。
如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员
→ 鸿蒙全栈最新学习笔记 希望这一份鸿蒙学习文档能够给大家带来帮助