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参数描述

• 代码示例

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

插入Profile信息

• PutDeviceProfile参数描述

• 代码示例

// 声明并填充插入数据
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参数描述

• 代码示例

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

同步Profile信息

• SyncDeviceProfile参数描述

• 代码示例

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

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

• SubscribeProfileEvents参数描述

• 代码示例

auto callback = std::make_shared<ProfileEventCallback>();
std::list<SubscribeInfo> subscribeInfos;
ExtraInfo extraInfo;
extraInfo["deviceId"] = deviceId;
extraInfo["serviceIds"] = serviceIds;

// 订阅EVENT_PROFILE_CHANGED事件
SubscribeInfo info1;
info1.profileEvent = ProfileEvent::EVENT_PROFILE_CHANGED;
info1.extraInfo = std::move(extraInfo);
subscribeInfos.emplace_back(info1);

// 订阅EVENT_SYNC_COMPLETED事件
SubscribeInfo info2;
info2.profileEvent = ProfileEvent::EVENT_SYNC_COMPLETED;
info2.extraInfo = std::move(extraInfo);
subscribeInfos.emplace_back(info2);

std::list<ProfileEvent> failedEvents;
// 执行订阅接口
DistributedDeviceProfileClient::GetInstance().SubscribeProfileEvents(subscribeInfos, callback, failedEvents);
sleep(SUBSCRIBE_SLEEP_TIME);
std::list<ProfileEvent> profileEvents;
profileEvents.emplace_back(ProfileEvent::EVENT_PROFILE_CHANGED);
failedEvents.clear();
// 解除订阅
DistributedDeviceProfileClient::GetInstance().UnsubscribeProfileEvents(profileEvents, callback, failedEvents);

相关仓

DeviceProfile子系统

device_info_manager