openharmory-鸿蒙生态设备之间文件互传发现、接入认证和文件传输

软件版本

OpenHarmony系统版本基线：基于 OpenHarmony-v5.0.0-Release。

图库应用版本：基于OpenHarmony-v5.0.0-Release。

文件管理器应用版本：基于OpenHarmony-v5.0.0-Release。

7 用户历程图

8 设备发现

8.1 设备交互流程图

8.2 设备发现流程

8.3 发现报文

OpenHarmony生态设备统一分享ADV报文

9 设备连接

9.1 设备连接认证流程

9.2 BLE 连接

9.3 设备认证

9.3.1 无账号PIN认证

9.4 WiFi 连接

9.4.1 P2P连接

通过软总线在OpenSession时，选择.linkType[0] = LINK_TYPE_WIFI_P2P，由软总线自动建立p2p连接。

10 文件传输

10.1 传输协议

10.2 传输流程

10.3 图片传输

图片传输的流程如下：

建立图片传输会话时，会话类型为图片传输，并且在会话信息里需要带上图片和视频缩略图的base64编码。发送和接收端都在图片传输开始时显示图片和视频的缩略图。

10.3.1 单图片/视频传输

单图片传输时，会话和传输列表只包含一个文件。传输进度按文件发送的字节大小百分比计算，取整数。

10.3.2 多图片/视频传输

多图片传输时，会话和传输列表只包含多个文件，可以使图片和适配混合一起发送。传输进度按文件发送的字节大小百分比计算，取整数。

10.4.1 文件传输

文件传输的流程如下：

建立文件传输会话时，会话类型为文件传输，会话信息里缩略图字段为空。发送和接收端都在图片传输开始时显示文件列表。

10.4.1 单文件传输

单文件传输时，会话和传输列表只包含一个文件。传输进度按文件发送的字节大小百分比计算，取整数。

10.4.2 多文件传输

多文件传输时，会话和传输列表只包含多个文件。传输进度按文件发送的字节大小百分比计算，取整数。

10.5 文件目录传输

选择文件目录传输时，单次传输只能选择1个文件夹。取文件夹里的文件列表进行传输，当文件夹为空时，不允许传输，并且提示用户。传输进度按文件发送的字节大小百分比计算，取整数。

11 接口定义

此章节定义和描述文件分享SDK的NAPI相关接口，提供给应用层APP调用。

11.1. 创建文件分享管理实例

createShareManager(bundleName: string): ShareManager

创建文件分享管理实例。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

无

错误码：

11.2. 释放文件分享管理实例

releaseShareManager(shareManager: ShareManager): void

释放文件分享管理实例，释放系统资源。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

无

错误码：

11.3. 开启文件分享

ShareManager.enableShare(): void

Sink端开启文件分享能力，启动设备文件分享BLE广播，使设备可以被文件分享发现。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

无

错误码：

11.4. 关闭文件分享

ShareManager.disableShare(): void

Sink端关闭文件分享能力，停止设备文件分享BLE广播，设备无法被文件分享发现。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

无

错误码：

11.5. 获取文件分享状态

ShareManager.getShareStatus(): boolean

Sink端获取文件分享状态。

系统能力：

SystemCapability.Communication.Share

需要权限：

返回值：

错误码：

11.6. 开始扫描设备

ShareManager.startScan(): void

Source端开始扫描文件分享设备广播。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

无

错误码：

11.7. 停止扫描设备

ShareManager.stopScan(): void

Source端停止扫描文件分享设备广播。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

无

错误码：

11.8. 连接设备

ShareManager.connect(deviceId: string, bindParam: { [key: string]: Object },
callback: AsyncCallback<{ deviceId: string }>): void

Source端连接对端设备。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.9. 关闭连接

ShareManager.disconnect(deviceId: string): void

Source端取消设备连接。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.10. 接受文件分享连接

ShareManager.confirmConnect(): void

Sink端确认接受文件分享连接。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.11. 拒绝文件分享连接

ShareManager.refuseConnect(): void

Sink拒绝文件分享，终止文件分享流程。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.12. 发送文件

ShareManager.sendFile(deviceId: string, type: ShareType, files: Array): void

Source端发送文件内容。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.12. 取消发送文件

ShareManager.cancelSendFile(deviceId: string): void

Source端取消发送文件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.13. 终止接收文件

ShareManager.abortReceiveFile(deviceId: string): void

Sink端终止接收文件内容。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.14. 注册连接改变事件

ShareManager.on(type: 'connectionChange', callback: Callback<{

action: ShareDeviceStateChange;

device: ShareDeviceInfo;

}>): void

注册连接状态改变事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.15. 取消注册连接状态改变事件

ShareManager.off(type: 'connectionChange'): void

取消注册连接状态改变事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.16. 注册发现设备成功事件

ShareManager.on(type: 'discoverSuccess', callback: Callback<{

device: ShareDeviceInfo;

}>): void

注册发现设备成功事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.17. 取消注册发现设备成功事件

ShareManager.off(type: 'discoverSuccess'): void

取消注册发现设备成功事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.18. 注册发现设备失败事件

ShareManager.on(type: 'discoverFailure', callback: Callback<{

reason: number;

}>): void

注册发现设备失败事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.19. 取消注册发现设备失败事件

ShareManager.off(type: 'discoverFailure'): void

取消注册发现设备失败事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.20. 注册文件分享开关状态改变事件

ShareManager.on(type: 'shareStatusChange', callback: Callback): void

注册文件分享开关状态改变事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：

11.21. 取消注册文件分享状态改变事件

ShareManager.off(type: 'shareStatusChange'): void

取消注册文件分享状态改变事件。

系统能力：

SystemCapability.Communication.Share

需要权限：

参数：

错误码：