【鸿蒙南向开发】OpenHarmony源码解析之获取显示状态功能

最新推荐文章于 2024-11-05 17:05:27 发布
最新推荐文章于 2024-11-05 17:05:27 发布
阅读量755 收藏 28
点赞数 30
分类专栏： 安卓 鸿蒙 前端 文章标签： harmonyos 华为 鸿蒙 安卓 前端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/HarmonyOS_666/article/details/140928009
版权
鸿蒙 同时被 3 个专栏收录
199 篇文章 11 订阅
订阅专栏
前端
199 篇文章 0 订阅
订阅专栏
安卓
198 篇文章 0 订阅
订阅专栏

1 简介

显示能效管理组件是OpenHarmony电源管理子系统的一个组件，主要负责如下功能：

  1. 显示屏的亮/灭。
  2. 显示屏亮度调节。
  3. 获取显示状态。

本文主要分析获取显示状态功能，包括NAPI接口及功能实现的整个流程。

图1 电源管理子系统架构图

image.png

图2 显示能效管理组件架构图

image.png

2 显示能效管理组件代码目录

base/powermgr/display_manager
├── figures                  	# 架构图
├── frameworks                  # FrameWork层
│   ├── napi                  	# NAPI
│   └── native                  # Native层
├── interfaces                  # 接口层
│   ├── innerkits               # 内部 APIs
│   └── kits                    # 外部接口 APIs
├── sa_profile                  # SA 配置文件
├── service                    	# 服务层
│   ├── native                  # Native 层
│   └── zidl                    # zidl 接口层
├── test                        # 测试用例
└── utils                       # 工具和通用层

3 获取显示状态整体流程

图3 获取显示状态时序图

image.png

流程描述：

  1. JavaScript应用调用getState获取显示状态
  2. getState调用brightness.cpp注册的NAPI接口GetDisplayState，GetDisplayState会将获取显示屏亮度委托给DisplayPowerMgrClient对象的GetDisplayState方法
  3. GetDisplayState首先获取显示服务代理端DisplayPowerMgrProxy对象，然后调用DisplayPowerMgrProxy的GetDisplayState方法
  4. 显示服务代理端对象的GetDisplayState方法调用SendRequest向显示服务提供方DisplayPowerMgrService发送获取显示状态请求
  5. DisplayPowerMgrService通过父类DisplayPowerMgrStub的OnRemoteRequest方法收到获取显示状态请求后，调用父类DisplayPowerMgrStub的GetDisplayStateStub方法
  6. GetDisplayStateStub继续调用DisplayPowerMgrService的GetDisplayState方法
  7. GetDisplayState根据设备id找到对应的ScreenController对象，然后调用ScreenController对象的GetState方法
  8. ScreenController调用其自身的公共方法GetState方法，直接返回自身的私有成员变量state_，state_变量在构造ScreenController对象时默认设置为on状态，并且可通过ScreenController对象的公共方法UpdateState去改变

3.1 显示能效管理服务注册

  1. 调用System Ability的MakeAndRegisterAbility接口注册Display Power Manager Service实例
//rk3568/base/powermgr/display_manager/service/native/src/display_system_ability.cpp

REGISTER_SYSTEM_ABILITY_BY_ID(DisplaySystemAbility, DISPLAY_MANAGER_SERVICE_ID, true);

//rk3568/foundation/distributedschedule/safwk/interfaces/innerkits/safwk/system_ability.h
#define REGISTER_SYSTEM_ABILITY_BY_ID(abilityClassName, systemAbilityId, runOnCreate) \
    const bool abilityClassName##_##RegisterResult = \
    SystemAbility::MakeAndRegisterAbility(new abilityClassName(systemAbilityId, runOnCreate));
  1. System Ability调用Display Power Manager Service的OnStart函数实现显示能效管理服务组件的启动
//rk3568/base/powermgr/display_manager/service/native/src/display_system_ability.cpp

void DisplaySystemAbility::OnStart()
{
    DISPLAY_HILOGI(MODULE_SERVICE, "Start service");
    //将Display Power Manager Service服务发布到System Ability，此时DisplayPowerMgrService成为了显示能效管理服务提供端
    if (!Publish(DelayedSpSingleton<DisplayPowerMgrService>::GetInstance())) {
        DISPLAY_HILOGE(MODULE_SERVICE, "Failed to publish service");
    }
}

3.2 显示屏亮度调节NAPI接口定义及实现

  1. NAPI接口声明
//rk3568/base/powermgr/display_manager/interfaces/kits/js/@ohos.brightness.d.ts

import { AsyncCallback } from './basic';

declare namespace brightness {
  function getState(): number;
  ...
}
export default brightness;
  1. NAPI接口实现，NAPI接口GetDisplayState会进一步调用显示屏亮度调节客户端DisplayPowerMgrClient对象提供的GetDisplayState方法
//rk3568/base/powermgr/display_manager/frameworks/napi/brightness.cpp

// 获取显示状态的NAPI接口初始化
static napi_value Init(napi_env env, napi_value exports)
{
    // 将JavaScript调用的getState NAPI接口实现声明为GetDisplayState函数
    napi_property_descriptor desc[] = {
        DECLARE_NAPI_FUNCTION("getState", GetDisplayState),
    };
    NAPI_CALL(env, napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc));

    DISPLAY_HILOGD(MODULE_JS_NAPI, "return");

    return exports;
}

//获取显示状态接口NAPI实现
static napi_value GetDisplayState(napi_env env, napi_callback_info info)
{
    DISPLAY_HILOGD(MODULE_JS_NAPI, "enter");

    size_t argc = 0;//参数个数
    napi_value args[1] = { 0 };//参数定义
    napi_value jsthis;//JS对象的this参数
    void *data = nullptr;//回调数据指针

    /* 根据环境变量获取参数 */
    napi_status status = napi_get_cb_info(env, info, &argc, args, &jsthis, &data);
    NAPI_ASSERT(env, (status == napi_ok) && (argc >= 0), "Bad parameters");

    napi_value result;
     // 调用客户端DisplayPowerMgrClient对象提供的GetDisplayState方法
    DisplayState state = DisplayPowerMgrClient::GetInstance().GetDisplayState();
    //创建js接口的返回值
    napi_create_uint32(env, static_cast<uint32_t>(state), &result);
    DISPLAY_HILOGD(MODULE_JS_NAPI, "return");
    return result;
}

3.3 获取显示状态客户端实现

  1. DisplayPowerMgrClient首先会调用GetProxy方法，GetProxy会通过GetSystemAbilityManager方法获取SystemAbilityManager实例，然后通过CheckSystemAbility方法检查对应的SA是否存在，并返回remoteObject对象，最后通过iface_cast构造proxy对象，此时创建了PowerMgrProxy实例
  2. 然后DisplayPowerMgrClient会将显示状态获取委托给显示服务代理端DisplayPowerMgrProxy对象的GetDisplayState方法处理。
//rk3568/base/powermgr/display_manager/frameworks/native/display_power_mgr_client.cpp

// 调用方不提供id参数，id默认为0，表示本地显示设备
DisplayState DisplayPowerMgrClient::GetDisplayState(uint32_t id)
{
    // 获取显示服务的代理端，这里返回的是DisplayPowerMgrProxy对象（service/zidl/src/display_power_mgr_proxy.cpp）
    auto proxy = GetProxy();
    if (proxy == nullptr) {
        //如果没有获取到proxy，则显示状态返回unknown
        return DisplayState::DISPLAY_UNKNOWN;
    }
     // 调用DisplayPowerMgrProxy的GetDisplayState，通过ipc方式获取显示状态结果
    return proxy->GetDisplayState(id);
}

// 获取显示管理服务提供的代理对象
sptr<IDisplayPowerMgr> DisplayPowerMgrClient::GetProxy()
{
    std::lock_guard lock(mutex_);
    if (proxy_ != nullptr) {
        return proxy_;
    }
    //  获取本设备内注册的SA的proxy
    sptr<ISystemAbilityManager> sam = SystemAbilityManagerClient::GetInstance().GetSystemAbilityManager();
    if (sam == nullptr) {
        DISPLAY_HILOGE(MODULE_INNERKIT, "Failed to get system ability manager");
        return nullptr;
    }
    // 检查显示管理服务是否注册
    sptr<IRemoteObject> obj = sam->CheckSystemAbility(DISPLAY_MANAGER_SERVICE_ID);
    if (obj == nullptr) {
        DISPLAY_HILOGE(MODULE_INNERKIT, "Failed to get display manager service");
        return nullptr;
    }
    sptr<IRemoteObject::DeathRecipient> dr = new DisplayDeathRecipient(*this);
    if ((obj->IsProxyObject()) && (!obj->AddDeathRecipient(dr))) {
        DISPLAY_HILOGE(MODULE_INNERKIT, "Failed to add death recipient");
        return nullptr;
    }
    // 将obj转换成IDisplayPowerMgr具体类型：DisplayPowerMgrProxy
    proxy_ = iface_cast<IDisplayPowerMgr>(obj);
    deathRecipient_ = dr;
    DISPLAY_HILOGI(MODULE_INNERKIT, "Succeed to connect display manager service");
    // 返回DisplayPowerMgrProxy对象
    return proxy_;
}

3.4 获取显示状态服务代理端实现

DisplayPowerMgrProxy对象会将获取显示状态请求以IPC方式发送给显示服务提供端DisplayPowerMgrService对象处理。

//rk3568/base/powermgr/display_manager/service/zidl/src/display_power_mgr_proxy.cpp

// 显示服务代理端显示状态获取功能实现
DisplayState DisplayPowerMgrProxy::GetDisplayState(uint32_t id)
{
    sptr<IRemoteObject> remote = Remote();
    RETURN_IF_WITH_RET(remote == nullptr, DisplayState::DISPLAY_UNKNOWN);

    uint32_t result = 0;
    MessageParcel data;
    MessageParcel reply;
    MessageOption option;

    if (!data.WriteInterfaceToken(DisplayPowerMgrProxy::GetDescriptor())) {
        DISPLAY_HILOGE(MODULE_INNERKIT, "DisplayPowerMgrClient::%{public}s write descriptor failed!", __func__);
        return DisplayState::DISPLAY_UNKNOWN;
    }

    WRITE_PARCEL_WITH_RET(data, Uint32, id, DisplayState::DISPLAY_UNKNOWN);

    // 将请求发送给显示服务的stub端，消息类型是GET_DISPLAY_STATE
    int ret = remote->SendRequest(static_cast<int>(IDisplayPowerMgr::GET_DISPLAY_STATE),
        data, reply, option);
    if (ret != ERR_OK) {
        DISPLAY_HILOGE(MODULE_INNERKIT, "DisplayPowerMgrProxy::%{public}s SendRequest is failed,%d", __func__, ret);
        return DisplayState::DISPLAY_UNKNOWN;
    }

    // 获取显示服务stub显示状态获取结果，如果无法获取结果，则返回unknown
    if (!reply.ReadUint32(result)) {
        DISPLAY_HILOGE(MODULE_INNERKIT, "Readback fail!");
        return DisplayState::DISPLAY_UNKNOWN;
    }

    // 返回显示服务stub端执行结果
    return static_cast<DisplayState>(result);
}

3.5 获取显示状态服务提供端实现

DisplayPowerMgrStub会将获取显示状态转发给子类DisplayPowerMgrService的SetBrightness方法处理

//rk3568/base/powermgr/display_manager/service/zidl/src/display_power_mgr_stub.cpp

// 处理显示管理代理端发送的请求
int32_t DisplayPowerMgrStub::OnRemoteRequest(uint32_t code, MessageParcel &data, MessageParcel &reply,
    MessageOption &option)
{
    DISPLAY_HILOGD(MODULE_SERVICE, "DisplayPowerMgrStub::OnRemoteRequest, cmd = %d, flags= %d",
        code, option.GetFlags());
    std::u16string descripter = DisplayPowerMgrStub::GetDescriptor();
    std::u16string remoteDescripter = data.ReadInterfaceToken();
    if (descripter != remoteDescripter) {
        DISPLAY_HILOGE(MODULE_SERVICE, "DisplayPowerMgrStub::OnRemoteRequest failed, descriptor is not matched!");
        return E_GET_POWER_SERVICE_FAILED;
    }

    switch (code) {
        ...
        // 消息类型为GET_BRIGHTNESS的处理函数    
        case static_cast<int32_t>(IDisplayPowerMgr::GET_DISPLAY_STATE):
            ret = GetDisplayStateStub(data, reply);
            break;
        ...
        default:
            return IPCObjectStub::OnRemoteRequest(code, data, reply, option);
    }
}

// 显示亮度获取stub端处理函数
int32_t DisplayPowerMgrStub::GetDisplayStateStub(MessageParcel& data, MessageParcel& reply)
{
    uint32_t id = 0;

    READ_PARCEL_WITH_RET(data, Uint32, id, E_READ_PARCEL_ERROR);

    // 调用子类DisplayPowerMgrService的GetDisplayState方法
    DisplayState ret = GetDisplayState(id);
    // 将调用结果发送给显示管理代理端
    if (!reply.WriteUint32(static_cast<uint32_t>(ret))) {
        DISPLAY_HILOGE(MODULE_SERVICE, "Failed to write GetDisplayStateStub return value");
        return E_WRITE_PARCEL_ERROR;
    }
    return ERR_OK;
}

DisplayPowerMgrService会根据设备id找到对应的ScreenController对象，然后将显示状态获取转发给ScreenController对象的GetState方法处理

//rk3568/base/powermgr/display_manager/service/native/src/display_power_mgr_service.cpp

// 显示管理服务端获取显示状态实现函数
DisplayState DisplayPowerMgrService::GetDisplayState(uint32_t id)
{
    DISPLAY_HILOGI(MODULE_SERVICE, "GetDisplayState %{public}d", id);
    //根据设备id找到对应的ScreenController对象，如果没找到则返回unknown
    auto iterater = controllerMap_.find(id);
    if (iterater == controllerMap_.end()) {
        return DisplayState::DISPLAY_UNKNOWN;
    }
    // 返回ScreenController的GetState调用结果
    return iterater->second->GetState();
}

3.6 屏幕控制器实现

  1. ScreenController调用其自身的公共方法，直接返回自身的私有成员变量state_
  2. ScreenController在构造时会加载系统所支持的四个状态（on，dim，off，suspend）到map中，此时state_默认构造为on状态
  3. ScreenController私有成员变量state_可通过其公共方法UpdateState去改变
//rk3568/base/powermgr/display_manager/service/native/src/screen_controller.cpp

class ScreenController :
	public AnimateCallback,
    public std::enable_shared_from_this<ScreenController> {
public:
    ...
	DisplayState GetState()
    {
        //直接返回自身的私有成员变量state_
        return state_;
    };
    //ScreenController私有成员变量state_可通过其公共方法UpdateState去改变
    bool UpdateState(DisplayState state, uint32_t reason);
    ...
private:
    ...
    DisplayState state_;
    std::map<DisplayState, uint32_t> stateValues_;
    ...
};

//ScreenController在构造时会加载系统所支持的四个状态（on，dim，off，suspend）到map中，此时state_默认构造为on状态
ScreenController::ScreenController(uint64_t devId, std::shared_ptr<ScreenAction> action)
    : devId_(devId), state_(DisplayState::DISPLAY_ON), action_(action)
{
    DISPLAY_HILOGI(MODULE_SERVICE, "ScreenController created: %{public}d", static_cast<uint32_t>(devId_));
    stateValues_.emplace(DisplayState::DISPLAY_ON, DISPLAY_FULL_BRIGHTNESS);
    stateValues_.emplace(DisplayState::DISPLAY_DIM, DISPLAY_DIM_BRIGHTNESS);
    stateValues_.emplace(DisplayState::DISPLAY_OFF, DISPLAY_OFF_BRIGHTNESS);
    stateValues_.emplace(DisplayState::DISPLAY_SUSPEND, DISPLAY_SUSPEND_BRIGHTNESS);
    animator_ = nullptr;
}

总结

本文主要和大家分享了OpenHarmony电源管理子系统中获取显示状态功能的实现细节，对NAPI接口、显示服务请求端及显示服务提供端流程等，做了较为详细的代码说明，希望通过本文您能初步掌握电源管理子系统的关键功能和核心流程。

写在最后

●如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
●点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
●关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
●更多鸿蒙最新技术知识点，请移步前往小编：https://gitee.com/

在这里插入图片描述

OpenHarmony源码分析(二):系统安全
myxuan475的专栏
11-02 1554
系统、文件、设备、进程、运行环境安全：通过安全启动，一级一级的进行安全校验，来源验证确保所有的实体安全。文件、设备保护：使用DAC 和 MAC 访问控制策略进程保护： 使用了进程隔离保证了进程间不可见，通过Capabilities机制控制了访问权限。数据安全、设备互联安全、应用安全见后面内容。
鸿蒙（HarmonyOS）北向开发项目编译问题汇总
m0_70748458的博客
04-26 995
之后直接运行，会报错，会说项目的API版本与设备的API版本不匹配，也就是P30 pro即使升级了鸿蒙 3.0，也不支持API8的项目运行，参考上面我们获得的p30pro的API等级是6，也就意味着，如果需要程序在P30pro上运行，我们必须选择API6开发。学习路线图中的每一个技术点都能够紧贴企业需求，经过多次真实实践，每一个知识点、每一个项目，都是码牛课堂鸿蒙研发团队精心打磨和深度解析的成果，注重对学生的细致教学，每一步都确保学生能够真正理解和掌握。自动获取设备签名后，运行如下。
【鸿蒙南向开发】OpenHarmony源码解析之显示屏亮度获取功能
HarmonyOS_666的博客
08-02 672
NAPI接口声明...NAPI接口实现，NAPI接口GetValue会进一步调用显示屏亮度调节客户端DisplayPowerMgrClient对象提供的GetBrightness方法// 显示屏亮度获取的NAPI接口初始化// 将JavaScript调用的getValue NAPI接口实现声明为GetValue函数//显示屏亮度获取接口NAPI实现//参数个数//参数定义//JS对象的this参数//回调数据指针/* 根据环境变量获取参数 */
OpenHarmony—内核对象事件之源码详解
weixin_34170737的博客
09-03 217
对于嵌入式开发工作人员和技术爱好者来说，深入了解常见任务间 IPC，有助于学习和研发内核。本文将从数据结构和算法解析 OpenHarmony 的事件机制，带大家深入了解内核任务间 IPC 原理。关键数据结构在解读事件的源码之前，首先了解下事件的关键的数据结构 PEVENT_CB_S：登录后复制 typedef struc...
OpenHarmony相机系统详解
程序猿老樊的博客
04-30 611
相机框架中主要包含会话管理、设备输入和数据输出，设备的输入和数据的输出配置都是在采集会话中完成，会话管理模块管理相机设备输入和数据输出。底层硬件提供了相机设备功能，比如相机的设备管理，包括相机设备枚举、相机设备能力查询、流的创建管理以及图像的捕获。相机组件支持相机业务的开发，开发者可以通过已开放的接口实现相机硬件的访问、操作和新功能开发，最常见的操作如：预览、拍照和录像等。(3).数据输出：相机的输出有拍照输出、预览输出和录像输出，分别对应三个不同的类，所以上层需要根据不同的场景创建出不同的数据输出。
【鸿蒙南向开发】OpenHarmony 源码解析之多模输入子系统（事件派发流程）
HarmonyOS_666的博客
08-05 1139
通过本文的学习可以了解多模输入系统事件派发的流程，以及多模输入系统的接口和注入事件的流程，结合以上的源码分析会对多模输入子系统会有更深入的理解。●如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：●关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
OpenHarmony 实战开发——内核对象事件之源码详解
maniuT的博客
05-16 466
对于嵌入式开发工作人员和技术爱好者来说，深入了解常见任务间 IPC，有助于学习和研发内核。本文将从数据结构和算法解析 OpenHarmony 的事件机制，带大家深入了解内核任务间 IPC 原理。
Harmony鸿蒙南向外设驱动开发-USB
m0_64420071的博客
04-13 1797
USB（Universal Serial Bus）通用串行总线，包含了主机端（Host）和设备端（Device）。
OpenHarmony南向开发 SA服务SELinux权限配置一站式傻瓜式教程
她的吻让他
08-09 1045
SELinux是Security Enhanced Linux 的缩写，也就是安全强化的 Linux，旨在增强传统Linux操作系统的安全性，解决传统Linux系统中自主访问控制（DAC）系统中的各种权限问题（如root权限过高等）。这里举一个例子便于理解，假设系统中某个服务进程出现了一个漏洞，使得某个远程用户可以访问系统的敏感文件（如/etc/dev）。
OpenHarmony南向开发—如何快速上手GN
m0_70748458的博客
04-27 1285
最近在研究鸿蒙操作系统的开源项目OpenHarmony，该项目使用了GN+Ninja工具链进行配置，编译，于是开始研究GN如何使用。
Harmony鸿蒙南向外设驱动开发-Audio
m0_64420071的博客
04-12 1423
本文主要介绍基于HDF（Hardware Driver Foundation）驱动框架开发的Audio驱动，包括Audio驱动的架构组成和功能部件
【详细深入分析OpenHarmony编译流程】
weixin_40870382的博客
03-31 7114
OpenHarmony做为复杂的操作系统软件，其编译构建也比较复杂。本文主要记录作者自己在阅读编译脚本代码后对其的认识，不代表官方观点，不足之处还请批评指正。本文顺着编译流程阅读和解释编译脚本代码，即执行时间靠前的代码先解释，执行时间靠后的代码后解释。本文参考代码为2024年7月8日master分支代码。为了方便查看OpenHarmony代码，作者搭建了一个服务器，欢迎使用https://lengqinjie.xyz。
openharmony电源管理子系统初探
weixin_54516968的博客
08-09 656
openharmony 电源管理子系统
鸿蒙OpenHarmony【电源模式定制开发】子系统电源管理
最新发布
woshishei9527的博客
11-05 287
OpenHarmony默认提供了电源模式（如正常模式、性能模式、省电模式、超级省电模式）的特性。但由于不同产品的部件存在差异，导致在同样场景下电源模式的配置需要也存在差异，为此，OpenHarmony提供了电源管理的定制方式，产品定制开发者可根据产品的设计规格来定制这些特性。
鸿蒙OpenHarmony【电池温度保护定制开发】子系统电源管理
woshishei9527的博客
11-03 555
OpenHarmony默认提供了电池温度保护的特性。终端设备会在不同的温度环境中使用，当温度过高或过低时，都会影响到电池的安全性，因此需要进行一定的温度保护措施，如当温度过高或过低时，将设备关机。但是不同的电池设备支持的温度范围不同，需要根据产品的设计规格来定制此特性。为此OpenHarmony提供了电池温度保护的定制方式，产品定制开发者可根据产品的设计规格来定制此特性。
OpenHarmony常用调试命令
mart!nhu的博客
02-17 6008
OpenHarmony 常用调试命令
鸿蒙OpenHarmony【关机充电动画开发】子系统电源管理
woshishei9527的博客
11-04 826
OpenHarmony默认提供了关机充电动画的特性，展示关机状态下的充电电量、充电动画等信息。由于定制厂商希望定制符合自身规则和特点的显示样式，希望根据产品的设计规格来定制此特性。为此OpenHarmony提供了关机充电动画的定制方式，产品定制开发者可根据产品的设计规格来定制此特性。
OpenHarmony 关闭息屏方式总结
Abner_Crazy的博客
12-01 2293
OpenHarmony 关闭息屏方式总结
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值