分布式DeviceProfile部件

• 简介
• 目录
• 约束
• 使用
• 相关仓

简介

DeviceProfile是设备硬件能力和系统软件特征的管理器，典型的Profile包括设备类型、设备名称、设备OS类型、OS版本号等。DeviceProfile提供快速访问本地及远端设备Profile的能力，是发起分布式业务的基础。主要功能如下：

• 本地设备Profile的插入、删除、查询。
• 远程设备Profile的查询。
• 订阅远程Profile变化的通知。
• 跨设备同步Profile。

DeviceProfile模块组成如下图所示：

系统架构

图 1 DeviceProfile组件架构图

目录

DeviceProfile主要代码目录结构如下：

├── interfaces
│   └── innerkits
│       └── distributeddeviceprofile            // innerkits接口
├── ohos.build
├── sa_profile                                  // said声明文件
│   ├── 6001.xml
│   └── BUILD.gn
└── services
    └── distributeddeviceprofile
        ├── BUILD.gn
        ├── include
        │   ├── authority                       // 权限校验
        │   ├── contentsensor                   // CS数据采集头文件
        │   ├── dbstorage                       // 数据库操作头文件
        │   ├── devicemanager                   // 设备管理头文件
        │   └── subscribemanager                // 订阅管理头文件
        ├── src
        │   ├── authority                       // 权限校验
        │   ├── contentsensor                   // CS数据采集实现
        │   ├── dbstorage                       // 数据库操作实现
        │   ├── devicemanager                   // 设备管理实现
        │   └── subscribemanager                // 订阅管理实现
        └── test                                // 测试用例

约束

• 组网设备需在同一局域网中。
• 组网之前，需先完成设备绑定，绑定流程参见安全子系统中说明。

使用

查询Profile信息

• GetDeviceProfile参数描述

名称	类型	必填	描述
deviceId	std::string	是	查询指定设备的profile,空值表示查询本地
serviceId	std::string	是	查询的service id
profile	ServiceCharacteristicProfile	是	返回值

• 代码示例

// 声明返回值
ServiceCharacteristicProfile profile;
// 执行查询接口GetDeviceProfile
DistributedDeviceProfileClient::GetInstance().GetDeviceProfile(deviceId, serviceId, profile);
std::string jsonData = profile.GetCharacteristicProfileJson();
result.append("jsonData:" + jsonData + "\n");

插入Profile信息

• PutDeviceProfile参数描述

名称	类型	必填	描述
profile	ServiceCharacteristicProfile	是	需要插入的profile信息

• 代码示例

// 声明并填充插入数据
ServiceCharacteristicProfile profile;
profile.SetServiceId(serviceId);
profile.SetServiceType(serviceType);
nlohmann::json j;
j["testVersion"] = "3.0.0";
j["testApiLevel"] = API_LEVEL;
profile.SetCharacteristicProfileJson(j.dump());
// 执行插入接口PutDeviceProfile
DistributedDeviceProfileClient::GetInstance().PutDeviceProfile(profile);

删除Profile信息

• DeleteDeviceProfile参数描述

名称	类型	必填	描述
serviceId	std::string	是	删除特定serviceid的记录

• 代码示例

// 声明并填充插入数据
std::string serviceId = "test";
// DeleteDeviceProfile
DistributedDeviceProfileClient::GetInstance().DeleteDeviceProfile(serviceId);

同步Profile信息

• SyncDeviceProfile参数描述

名称	类型	必填	描述
syncOption	SyncOption	是	指定同步范围和模式
syncCb	IProfileEventCallback	是	同步结果回调

• 代码示例

// 定义同步模式和范围
SyncOptions syncOption;
syncOption.SetSyncMode((OHOS::DeviceProfile::SyncMode)atoi(mode.c_str()));
for (const auto& deviceId : deviceIds) {
    syncOption.AddDevice(deviceId);
}
// 执行同步接口
DistributedDeviceProfileClient::GetInstance().SyncDeviceProfile(syncOption,
    std::make_shared<ProfileEventCallback>());

订阅Profile事件（同步、变更事件）

• SubscribeProfileEvents参数描述

名称	类型	必填	描述
subscribeInfos	SubscribeInfo	是	指定订阅的事件类型
eventCb	IProfileEventCallback	是	订阅事件回调
failedEvents	ProfileEvent	是	失败事件

• 代码示例

auto callback = std::make_shared<ProfileEventCallback>();
std::list<SubscribeInfo> subscribeInfos;

// 订阅EVENT_PROFILE_CHANGED事件
ExtraInfo extraInfo;
extraInfo["deviceId"] = deviceId;
extraInfo["serviceIds"] = serviceIds;
SubscribeInfo changeEventInfo;
changeEventInfo.profileEvent = ProfileEvent::EVENT_PROFILE_CHANGED;
changeEventInfo.extraInfo = std::move(extraInfo);
subscribeInfos.emplace_back(changeEventInfo);

// 订阅EVENT_SYNC_COMPLETED事件
SubscribeInfo syncEventInfo;
syncEventInfo.profileEvent = ProfileEvent::EVENT_SYNC_COMPLETED;
subscribeInfos.emplace_back(syncEventInfo);

// 执行订阅接口
std::list<ProfileEvent> failedEvents;
DistributedDeviceProfileClient::GetInstance().SubscribeProfileEvents(subscribeInfos,
    callback, failedEvents);

// 解除订阅
std::list<ProfileEvent> profileEvents;
profileEvents.emplace_back(ProfileEvent::EVENT_PROFILE_CHANGED);
DistributedDeviceProfileClient::GetInstance().UnsubscribeProfileEvents(profileEvents,
    callback, failedEvents);

接口返回常用错误码

定义	返回值	返回值含义
DP_SUCCESS	0	DP成功
DP_INVALID_PARAMS	98566144	DP无效参数
DP_GET_LOCAL_UDID_FAILED	98566146	DP获取本段UDID失败
DP_GET_SERVICE_FAILED	98566147	DP获取服务失败
DP_INIT_DB_FAILED	98566148	DP初始化数据库失败
DP_NOT_INIT_DB	98566157	DP没有初始化数据库
DP_CACHE_EXIST	98566164	DP缓存存在
DP_PUT_KV_DB_FAIL	98566197	DP写入KV数据库失败
DP_DEL_KV_DB_FAIL	98566198	DP删除KV数据库失败
DP_GET_KV_DB_FAIL	98566199	DP查找KV数据库失败
DP_KV_SYNC_FAIL	98566204	DP KV同步失败
DP_NOT_FIND_DATA	98566221	DP找不到数据
DP_READ_PARCEL_FAIL	98566236	DP读取IPC失败
DP_WRITE_PARCEL_FAIL	98566235	DP写入IPC失败
DP_PERMISSION_DENIED	98566155	DP权限被拒绝
DP_PUT_TRUST_DEVICE_PROFILE_FAIL	98566218	DP写入可信设备配置文件失败
DP_PUT_ACL_PROFILE_FAIL	98566170	DP写入ACL配置文件失败
DP_GET_ALL_TRUST_DEVICE_PROFILE_FAIL	98566169	DP获取所有可信设备失败
DP_UPDATE_ACL_PROFILE_FAIL	98566171	DP修改ACL配置文件失败

相关仓

deviceprofile_device_info_manager