OH分布式软总线
- 概述
- 简介
- 分布式软总线的特征
- 官方说明
- 目录结构与代码说明
- 分布式软总线使用
- 使用说明
- 接口说明
- 发现
- 发现的接口
- C++示例说明
- 组网
- 组网的接口
- C++示例说明
- 传输
- 软总线传输关键流程
- 传输的接口
- 注意事项
一、概述
1.1 简介
分布式软总线能做什么？
1.1 通过共享一个局域网(wifi或蓝牙)，可以发现设备。
通过设备名等关键字可以查找到在共享的网络中所有设备，并进行通信。关键是不需要预告知晓对方设备的IP地址与端口。
1.2 支持消息、字节、流、文件的数据传输能力。
实际应用中，可以将文字、图片、文件或音视频流进行传输。
1.3 支持富设备、小型设备、轻量设备。
实际应用中，可以做到跨设备间使用。笔者在L0与L2、L2与L2等两类设备间测试通过。
现实中多设备间通信方式多种多样(wifi、NFC、蓝牙等)，不同的通信方式使用差异大，导致通信问题多;同时还面临设备间通信链路的整合共享和冲突无法处理等挑战。分布式软总线实现近场设备间统一的分布式通信管理能力，提供不区分链路的设备间发现连接、组网和传输能力，主要功能如下：
- 发现连接：提供基于wifi、蓝牙等通信方式的设备发现连接能力
- 设备组网：提供统一的设备组网和拓扑管理能力，为数据传输提供已组网设备信息
typedef enum {/* Passive 主动*/DISCOVER_MODE_PASSIVE = 0x55,//lite device support the passive mode only./* Proactive 被动*/DISCOVER_MODE_ACTIVE = 0xAA
} DiscoverMode;
//媒介
typedef enum {/* Automatic medium selection */AUTO = 0,/* Bluetooth*/BLE = 1,/* wifi*/COAP = 2,/* USB*/USB = 3,/* HiLink*/COAP1 = 4,MEDIUM_BUTT
} ExchangeMedium;
-
数据传输:提供数据传输通道，支持消息、字节数据传输等能力
业务方通过使用分布式软总线提供API实现设备间的高速通信，不用关心通信细节，进而实现业务平台的高效部署与运行能力。
//设备类型 DeviceType
typedef enum {/* Smart speaker */SMART_SPEAKER = 0x00,/* PC */DESKTOP_PC,/* LAPTOP */LAPTOP,/* Mobile phone */SMART_PHONE,/* Table */SMART_PAD,/* Smart watch */SMART_WATCH,/* Smart car */SMART_CAR,/* Kids' watch */CHILDREN_WATCH,/* Smart TV */SMART_TV,
} DeviceType;
typedef enum {CONNECT_ADDR_WLAN = 0, /**< WLAN wifi(无线局域网)*/CONNECT_ADDR_BR= 0, /**< BR 基础速率*/CONNECT_ADDR_BLE = 0, /**< BLE 低功耗蓝牙*/CONNECT_ADDR_ETH = 0, /**< Ethernet 以太网*/CONNECT_ADDR_MAX = 0, /**< Invalid type*/
} ConnectionAddrType;
1.2 分布式软总线的特征
- 自动发现/即连即用
- 高带宽
- 低时延
- 高可靠
- 开放/标准
软总线提出了自动发现的概念，实现用户零等待的自发现体验，附件同账号的设备自动发现无需等待。
多设备互联后的组技术：软总线组网-异构网络组网，比如：蓝牙-wifi。
设备上线后会向网络层注册，同时网络层会与设备建立通道连接，实时检测设备的变换。
网络层负责管理设备的上线下线变换，设备间可以监听自己感兴趣的设备，设备上线后可以立即与其建立连接，实现零等待。
软总线可以自动构建一个逻辑全连接网络，用户或者业务开发者无需关心组网方式与物理协议。对于软件开发者来说软总线异构组网可以大大降低开发成本。
1.3 官方说明
//foundation/communication/dsoftbus/README_zh.md
1.4 目录结构与代码说明
对照代码说明
二、分布式软总线使用
2.1 使用说明
- 使用跨设备通信时，必须添加权限ohos.permission.DISTRIBUTED_DATASYNC，该权限类型为 _*dangerous*_ 。
L2与L1设备通过检查softbus_trans_permission.json文件判断应用的传输权限，L0不用设置权限
- 设备主动发现手机时,手机需打开超级终端的允许被“附近设备”发现开关（设置-超级终端-我的设备-允许被发现-附近设备），才能被设备发现。
- 包含头文件
# C头文件
//foundation/communication/dsoftbus/interfaces/kits/discovery/discovery_service.h
#C++头文件
//foundation/communication/dsoftbus/sdk/discovery/ipc/include/disc_server_proxy.h
- 包含依赖包
# C依赖包
deps = ["//foundation/communication/dsoftbus/adapter:softbus_adapter","//foundation/communication/dsoftbus/core/common:softbus_utils",
]
# C++依赖包
deps = ["//foundation/communication/dsoftbus/sdk:softbus_client","//foundation/communication/dsoftbus/core/common:softbus_server",
]
2.2 接口说明
分布式软总线接口分为三类
- 发现
- 组网
- 传输
2.3 发现
2.3.1 发现接口
- C接口
//foundation/communication/dsoftbus/interfaces/kits/discovery/discovery_service.h
// 发布回调
typedef struct {void (*OnPublishSuccess)(int publishId); //发布成功时回调void (*OnPublishFail)(int publishId, PublishFailReason reason);//发布失败时回调
} IPublishCallback;
// 发布服务
int PublishService(const char *pkgName, const PublishInfo *info, const IPublishCallback *cb);
// 注销服务
int UnPublishService(const char *pkgName, int publishId);
// 发现回调
typedef struct {void (*OnDeviceFound)(const DeviceInfo *device); //发现设备回调void (*OnDiscoverFailed)(int subscribeId, DiscoveryFailReason failReason); //启动发现失败回调void (*O
)
