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

最新推荐文章于 2024-11-01 09:19:41 发布
最新推荐文章于 2024-11-01 09:19:41 发布
阅读量664 收藏 28
点赞数 9
分类专栏： 鸿蒙 安卓 前端 文章标签： harmonyos 华为 android 鸿蒙 前端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/HarmonyOS_666/article/details/140875322
版权
鸿蒙 同时被 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应用调用getValue获取显示屏亮度
  2. getValue调用brightness.cpp注册的NAPI接口GetValue，GetValue会将获取显示屏亮度委托给DisplayPowerMgrClient对象的GetBrightness方法
  3. GetBrightness首先获取显示服务代理端DisplayPowerMgrProxy对象，然后调用DisplayPowerMgrProxy的GetBrightness方法
  4. 显示服务代理端对象的GetBrightness方法调用SendRequest向显示服务提供方DisplayPowerMgrService发送获取屏幕亮度请求
  5. DisplayPowerMgrService通过父类DisplayPowerMgrStub的OnRemoteRequest方法收到获取屏幕亮度请求后，调用父类DisplayPowerMgrStub的GetBrightnessStub方法
  6. GetBrightnessStub继续调用DisplayPowerMgrService的GetBrightness方法
  7. GetBrightness根据设备id找到对应的ScreenController对象，然后调用ScreenController对象的GetBrightness方法
  8. ScreenController对象的GetBrightness方法调用ScreenAction对象的GetBrightness方法
  9. ScreenAction对象的GetBrightness方法调用DisplayManager的GetScreenBrightness操控底层硬件实现显示屏的亮度获取。

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 getValue(): number;
  ...
}
export default brightness;
  1. NAPI接口实现，NAPI接口GetValue会进一步调用显示屏亮度调节客户端DisplayPowerMgrClient对象提供的GetBrightness方法
//rk3568/base/powermgr/display_manager/frameworks/napi/brightness.cpp

// 显示屏亮度获取的NAPI接口初始化
static napi_value Init(napi_env env, napi_value exports)
{
    // 将JavaScript调用的getValue NAPI接口实现声明为GetValue函数
    napi_property_descriptor desc[] = {
        DECLARE_NAPI_FUNCTION("getValue", GetValue),
    };
    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 GetValue(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, "Failed to get cb info");

    // 调用客户端DisplayPowerMgrClient对象提供的GetBrightness方法
    uint32_t brightness = DisplayPowerMgrClient::GetInstance().GetBrightness();

    napi_value result;
    //创建js接口的返回值
    napi_create_uint32(env, brightness, &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对象的GetBrightness方法处理。
//rk3568/base/powermgr/display_manager/frameworks/native/display_power_mgr_client.cpp

// 调用方不提供id参数，id默认为0，表示本地显示设备
uint32_t DisplayPowerMgrClient::GetBrightness(uint32_t id)
{
    // 获取显示服务的代理端，这里返回的是DisplayPowerMgrProxy对象（service/zidl/src/display_power_mgr_proxy.cpp）
    auto proxy = GetProxy();
    if (proxy == nullptr) {
        return 0;
    }
    // 调用DisplayPowerMgrProxy的GetBrightness，通过ipc方式获取亮度结果
    return proxy->GetBrightness(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

// 显示服务代理端亮度获取功能实现
uint32_t DisplayPowerMgrProxy::GetBrightness(uint32_t id)
{
    sptr<IRemoteObject> remote = Remote();
    RETURN_IF_WITH_RET(remote == nullptr, false);

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

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

    WRITE_PARCEL_WITH_RET(data, Uint32, id, false);

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

    // 获取显示服务stub亮度获取结果，如果无法获取结果，则返回false
    if (!reply.ReadUint32(result)) {
        DISPLAY_HILOGE(MODULE_INNERKIT, "Readback fail!");
        return result;
    }

     // 返回显示服务stub端执行结果
    return 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_BRIGHTNESS):
            ret = GetBrightnessStub(data, reply);
            break;
        ...
        default:
            return IPCObjectStub::OnRemoteRequest(code, data, reply, option);
    }
}

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

    READ_PARCEL_WITH_RET(data, Uint32, id, E_READ_PARCEL_ERROR);

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

DisplayPowerMgrService会根据设备id找到对应的ScreenController对象，然后将亮度获取转发给ScreenController对象的GetBrightness方法处理

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

// 显示管理服务端亮度获取实现函数
uint32_t DisplayPowerMgrService::GetBrightness(uint32_t id)
{
    DISPLAY_HILOGI(MODULE_SERVICE, "SetBrightness %{public}d", id);
    //根据设备id找到对应的ScreenController对象
    auto iterater = controllerMap_.find(id);
    if (iterater == controllerMap_.end()) {
        return 0;
    }
    // 返回ScreenController的GetBrightness调用结果
    return iterater->second->GetBrightness();
}

3.6 屏幕控制器实现

ScreenController将亮度调节转发给ScreenAction对象的GetBrightness方法处理

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

uint32_t ScreenController::GetBrightness()
{
    std::lock_guard lock(mutex_);
    if (brightness_ == 0) {
    	// 调用ScreenAction::SetBrightness
        brightness_ = action_->GetBrightness(devId_);
    }
    return brightness_;
}

3.7 屏幕Action实现

ScreenAction最终调用底层驱动获取显示屏亮度

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

uint32_t ScreenAction::GetBrightness(uint64_t devId)
{
    DISPLAY_HILOGI(MODULE_SERVICE, "GetBrightness: %{public}d", static_cast<int>(devId));
    // 调用驱动亮度获取实现函数
    return Rosen::DisplayManager::GetInstance()
        .GetScreenBrightness(static_cast<uint64_t>(devId));
}

总结

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

写在最后

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

「已注销」
关注
专栏目录
OpenHarmony及鸿蒙应用的屏幕亮度获取以及设置
龚礼鹏的博客
05-31 356
对应的OpenHarmony版本：V3.2查找资料发现V3.2版本的OpenHarmony没有获屏幕亮度的接口，只有设置屏幕亮度的接口，这个就很奇怪，所以我最终的方案是获取屏幕亮度使用老的接口，设置屏幕亮度使用新的接口，这样就完成了这个需求。
鸿蒙OS开发实例：【工具类封装-首选项本地存储】
m0_62167422的博客
03-28 1610
而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点如果。
鸿蒙语言基础类库：【@system.brightness (屏幕亮度)】
2301_76813281的博客
07-15 1198
设置屏幕是否保持常亮状态，开启常亮模式推荐在onShow()阶段调用。设置设备当前的屏幕亮度模式。获得设备当前的屏幕亮度值。设置设备当前的屏幕亮度值。获得当前屏幕亮度模式。
鸿蒙5.0【OpenHarmony】图形HDI基础适配及点屏
2401_82772199的博客
08-23 682
drm驱动是显卡驱动的一种架构。相比FB架构，DRM更能适应当前日益更新的显示硬件。比如FB原生不支持多层合成，不支持VSYNC，不支持DMA-BUF，不支持异步更新，不支持fence机制等等，而这些功能DRM原生都支持。同时DRM可以统一管理GPU和Display驱动，使得软件架构更为统一，方便管理和维护。
鸿蒙开发设备管理：【@ohos.brightness (屏幕亮度)】
2301_76813281的博客
06-28 420
该模块提供屏幕亮度的设置接口。本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
普法OpenHarmony送显流程
IT先森
05-06 3827
OpenHarmony送显流程分析OpenHarmony送显流程分析引言本文档主要记录OpenHarmony在渲染完成之后如何进行合成和送显流程的。这个过程牵涉的代码很多，而且流程也是比较繁琐的。所以我一定要坚持下来。千万不能半途而废，也不要想着一口气吃出一个胖子，路漫漫其修远兮吾将上下而求索！一. 应用端发送NextVSnc请求，服务端响应还记得那年大明湖畔的夏雨荷吗！
鸿蒙南向开发环境的搭建（OpenHarmony）
m0_70748458的博客
04-26 2250
在嵌入式开发中，很多开发者习惯于使用Windows进行代码的编辑，比如使用Windows的Visual StudioCode进行OpenHarmony代码的开发。但当前阶段，大部分的开发板源码还不支持在Windows环境下进行编译，如Hi3861、Hi3516系列开发板。因此，建议使用Ubuntu的编译环境对源码进行编译。
HarmonyOS——OpenHarmony源码.pdf
12-15
《 HarmonyOS 开源之旅：OpenHarmony源码获取与开发指南》 OpenHarmony，作为HarmonyOS的开源版本，由华为公司捐赠给开放原子开源基金会（OpenAtom Foundation）。其首个开源版本支持在128KB至128MB设备上运行，为...
OpenHarmony源码解析之编译构建
m0_70748458的博客
04-26 1620
OpenHarmony是由开放原子开源基金会（OpenAtom Foundation）孵化及运营的开源项目，目标是面向全场景、全连接、全智能时代、基于开源的方式，搭建一个智能终端设备操作系统的框架和平台，促进万物互联产业的繁荣发展。最近在学习OpenHarmony源代码，个人认为学习有三个阶段，分别是看、实操、写（归纳总结），本着追求学习的终极目标，因此有了这篇文章
OpenHarmony4.0源码解析之媒体框架
2401_82772199的博客
02-26 1259
从框架图中可以看出，媒体框架的主要工作模式为通过 Gstreamer 的插件自动化注册及插件组合功能，将其余媒体播放相关的框架功能插件化，配合 Gstreamer 自身丰富的插件，共同来对外提供音视频的录制与播放功能。如通过 audio-sink 及 audio-source 插件调用音频框架的播放及采集功能来实现音频的播放与录制；通过 surface-sink 调用图形框架，video-decoder 调用解码驱动模块实现视频的硬解播放等。
OpenHarmony如何控制屏幕亮度
坚果的博客
09-29 6122
/ 必须要指定初始进度 total?: number;style?type?value：表示当前进度，取值范围[0, 100]，当超过 100 时无效。total：表示进度条总进度，默认值为100。type、style：设置进度条的样式，style从 API 8 起使用type代替，定义了以下 种样式：Linear：进度条样式为条形进度条。Eclipse：进度条样式为圆形进度条。Ring：环形进度条。ScaleRing：环形刻度进度条。Capsule：胶囊样式进度条。
openharmony电源管理子系统初探
weixin_54516968的博客
08-09 647
openharmony 电源管理子系统
【鸿蒙南向开发】OpenHarmony源码解析之获取显示状态功能
HarmonyOS_666的博客
08-05 732
NAPI接口声明...NAPI接口实现，NAPI接口GetDisplayState会进一步调用显示屏亮度调节客户端DisplayPowerMgrClient对象提供的GetDisplayState方法// 获取显示状态的NAPI接口初始化// 将JavaScript调用的getState NAPI接口实现声明为GetDisplayState函数//获取显示状态接口NAPI实现//参数个数//参数定义//JS对象的this参数//回调数据指针/* 根据环境变量获取参数 */
2024年鸿蒙最全OpenHarmony如何控制屏幕亮度_openharmony 熄屏，升职面试问题回答技巧
2401_84857523的博客
05-15 892
/ 必须要指定初始进度total?: number;style?type?value：表示当前进度，取值范围[0, 100]，当超过 100 时无效。total：表示进度条总进度，默认值为100。typestyle：设置进度条的样式，style从 API 8 起使用type代替，定义了以下 种样式：Linear：进度条样式为条形进度条。Eclipse：进度条样式为圆形进度条。Ring：环形进度条。ScaleRing：环形刻度进度条。Capsule：胶囊样式进度条。
鸿蒙南向开发实战：系统亮度范围定制开发（显示管理）
shudaoshanQAQ的博客
04-30 718
OpenHarmony默认的亮度范围为0 ~ 255........
开发板如何适配OpenHarmony 3.2
OpenHarmony_dev的博客
04-04 3235
编译脚本会先把kernel/linux/linux-5.10拷贝到out/kernel/src_tmp/linux-5.10/，然后打上3568的内核补丁patch -p1 < kernel/linux/patches/linux-5.10/rk3568_patch/kernel.patch后编译生成自己的镜像，不利于我们开发，我们自己开发过程中做如下修改，这样方便我们开发过程中的修改。
HarmonyOS 5.0应用开发——用户文件操作
最新发布
高心星的专栏
11-01 569
用户文件：文件所有者为登录到该终端设备的用户，包括用户私有的图片、视频、音频、文档等。 用户文件存放在用户目录下，归属于该设备上登录的用户。 用户文件存储位置主要分为内置存储、外置存储。 应用对用户文件的创建、访问、删除等行为，需要提前获取用户授权，或由用户操作完成。
鸿蒙进阶篇-Swiper组件的使用
2401_88463044的博客
10-30 786
在科技的浪潮中，鸿蒙操作系统宛如一颗璀璨的新星，引领着创新的方向。作为鸿蒙开天组，今天我们将一同踏上鸿蒙基础的探索之旅，为您揭开这一神奇系统的神秘面纱。各位小伙伴们我们又见面了,我就是鸿蒙开天组,下面让我们进入今天的学习,鸿蒙进阶篇-Swiper组件的使用。
初体验鸿蒙 HarmonyOS NEXT开发
dawn0718的专栏
10-30 338
使用华为DevEco Studio做手机应用的初体验。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值