鸿蒙开发接口图形图像：【@ohos.screen (屏幕)】

最新推荐文章于 2024-09-14 18:21:07 发布
最新推荐文章于 2024-09-14 18:21:07 发布
阅读量940 收藏 10
点赞数 14
分类专栏： 鸿蒙 文章标签： harmonyos 鸿蒙开发 鸿蒙系统 OpenHarmony 移动开发 程序员 接口
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/139278857
版权

 屏幕

本模块提供管理屏幕的一些基础能力，包括获取屏幕对象，监听屏幕变化，创建和销毁虚拟屏幕等。

说明：
开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口为系统接口。

导入模块

import screen from '@ohos.screen';

screen.getAllScreens

getAllScreens(callback: AsyncCallback<Array<Screen>>): void

获取所有的屏幕，使用callback异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
callbackAsyncCallback<Array<[Screen]>>是回调函数。返回当前获取的屏幕对象集合。

示例：

var screenClass = null;
screen.getAllScreens((err, data) => {
    if (err.code) {
        console.error('Failed to get all screens . Cause:  ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in getting all screens . Data:' + JSON.stringify(data));
    screenClass = data[0];
});

screen.getAllScreens

getAllScreens(): Promise<Array<Screen>>

获取所有的屏幕，使用Promise异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

返回值：

类型说明
Promise<Array<[Screen]>>Promise对象。返回当前创建的屏幕对象集合。

示例：

var screenClass = null;
let promise = screen.getAllScreens();
promise.then((data) => {
    screenClass = data[0];
    console.log('Succeeded in getting all screens . Data:'+ JSON.stringify(data));
}).catch((err) => {
    console.log('Failed to get all screens . Cause: ' + JSON.stringify(err));
});

screen.on('connect' | 'disconnect' | 'change')

on(eventType: 'connect' | 'disconnect' | 'change', callback: Callback<number>): void

开启屏幕状态变化的监听。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
eventTypestring是监听事件。 -eventType为"connect"表示屏幕连接事件。 -eventType为"disconnect"表示断开屏幕连接事件。 -eventType为"change"表示屏幕状态改变事件。
callbackCallback<number>是回调函数。返回屏幕的id。

示例：

var callback = (data) => {
    console.info('Register the callback for screen changes. Data: ' + JSON.stringify(data))
};
screen.on("connect", callback);

screen.off('connect' | 'disconnect' | 'change')

off(eventType: 'connect' | 'disconnect' | 'change', callback?: Callback<number>): void

关闭屏幕状态变化的监听。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
eventTypestring是监听事件。 -eventType为"connect"表示屏幕连接事件。 -eventType为"disconnect"表示断开屏幕连接事件。 -eventType为"change"表示屏幕状态改变事件。
callbackCallback<number>否回调函数。返回屏幕的id。

示例：

var callback = (data) => {
    console.info('Unegister the callback for screen changes. Data: ' + JSON.stringify(data))
};
screen.off("connect", callback);

screen.makeExpand

makeExpand(options:Array<ExpandOption>, callback: AsyncCallback<number>): void

将屏幕设置为扩展模式，使用callback异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
optionsArray<[ExpandOption]>是设置扩展屏幕的参数集合。
callbackCallback<number>是回调函数。返回扩展屏幕的群组id。

示例：

var groupId = null;
screen.makeExpand([{screenId: 0, startX: 0, startY: 0}, {screenId: 1, startX: 1080, startY: 0}], (err, data) => {
  if (err.code) {
    console.error('Failed to make screens as expand-screen. Cause:' + JSON.stringify(err));
    return;
  }
  groupId = data;
  console.info('Succeeded in making screens as expand-screen.Data:' + JSON.stringify(data));
});

screen.makeExpand

makeExpand(options:Array<ExpandOption>): Promise<number>

将屏幕设置为扩展模式，使用Promise异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
optionsArray<[ExpandOption]>是设置扩展屏幕的参数集合。

返回值：

类型说明
Promise<number>Promise对象。返回扩展屏幕的群组id。

示例：

screen.makeExpand([{screenId: 0, startX: 0, startY: 0}, {screenId: 1, startX: 1080, startY: 0}]).then((data) => {
  console.info('Succeeded in making screens as expand-screen.Data:' + JSON.stringify(data));
}).catch((err) => {
  console.error('Failed to make screens as expand-screen. Cause:' + JSON.stringify(err));
});

screen.makeMirror

makeMirror(mainScreen:number, mirrorScreen:Array<number>, callback: AsyncCallback<number>): void

将屏幕设置为镜像模式，使用callback异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
mainScreennumber是主屏幕id。
mirrorScreenArray<number>是镜像屏幕id集合。
callbackAsyncCallback<number>是回调函数。返回镜像屏幕的群组id。

示例：

var mainScreenId = 0;
var mirrorScreenIds = [1, 2, 3];
screen.makeMirror(mainScreenId, mirrorScreenIds, (err, data) => {
  if (err.code) {
    console.error('Failed to make screens as mirror-screen.Cause:' + JSON.stringify(err));
    return;
  }
  console.info('Succeeded in making screens as mirror-screen.Data:' + JSON.stringify(data));
});

screen.makeMirror

makeMirror(mainScreen:number, mirrorScreen:Array<number>): Promise<number>

将屏幕设置为镜像模式，使用Promise异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数：

参数名类型必填说明
mainScreennumber是主屏幕id。
mirrorScreenArray<number>是镜像屏幕id集合。

返回值：

类型说明
Promise<number>Promise对象。返回镜像屏幕的群组id。

示例：

var mainScreenId = 0;
var mirrorScreenIds = [1, 2, 3];
screen.makeMirror(mainScreenId, mirrorScreenIds).then((data) => {
  console.info('Succeeded in making screens as mirror-screen.Data:' + JSON.stringify(data));
}).catch((err) => {
  console.error('Failed to make screens as mirror-screen.Cause:' + JSON.stringify(err));
});

ExpandOption

扩展屏幕的参数。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

名称参数类型可读可写说明
screenIdnumber是是屏幕的id。
startXnumber是是屏幕的起始X轴坐标。
startYnumber是是屏幕的起始Y轴坐标。

Screen

屏幕实例。

下列API示例中都需先使用[getAllScreens()]方法获取到Screen实例，再通过此实例调用对应方法。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

名称参数类型可读可写说明
idnumber是否屏幕的id。
parentnumber是否屏幕所属群组的id。
supportedModeInfoArray<[ScreenModeInfo]>是否屏幕支持的模式集合。
activeModeIndexnumber是否当前屏幕所处模式索引。
orientation[Orientation]是否屏幕方向。

setOrientation

setOrientation(orientation: Orientation, callback: AsyncCallback<void>): void

设置屏幕方向，使用callback异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数名类型必填说明
orientation[Orientation]是屏幕方向。
callbackAsyncCallback<void>是回调函数。当设置屏幕方向成功，err为undefined，否则为错误对象。

示例：

screenClass.setOrientation(screen.Orientation.VERTICAL, (err, data) => {
    if (err.code) {
        console.error('Failed to setOrientation VERTICAL. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting Orientation VERTICAL. data: ' + JSON.stringify(data));
})

setOrientation

setOrientation(orientation: Orientation): Promise<void>

设置屏幕方向，使用Promise异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数名类型必填说明
orientation[Orientation]是屏幕方向。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

示例：

let promise = screenClass.setOrientation(screen.Orientation.VERTICAL);
promise.then((data) => {
    console.info('Succeeded in setting Orientation VERTICAL. Data: ' + JSON.stringify(data));
}).catch((err) => {
    console.error('Failed to set Orientation VERTICAL. Cause: ' + JSON.stringify(err));
})

setScreenActiveMode

setScreenActiveMode(modeIndex: number, callback: AsyncCallback<void>): void

设置屏幕当前显示模式，使用callback异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数名类型必填说明
modeIndexnumber是模式索引。
callbackAsyncCallback<void>是回调函数。当设置屏幕当前显示模式成功，err为undefined，否则为错误对象。

示例：

var modeIndex = 0;
screenClass.setScreenActiveMode(modeIndex, (err, data) => {
    if (err.code) {
        console.error('Failed to set ScreenActiveMode 0. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in setting ScreenActiveMode 0. data: ' + JSON.stringify(data));
})

setScreenActiveMode

setScreenActiveMode(modeIndex: number): Promise<void>

设置屏幕当前显示模式，使用Promise异步回调。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

参数名类型必填说明
modeIndexnumber是模式索引。

返回值：

类型说明
Promise<void>无返回结果的Promise对象。

示例：

var modeIndex = 0;
let promise = screenClass.setScreenActiveMode(modeIndex);
promise.then((data) => {
    console.info('Succeeded in setting ScreenActiveMode 0. Data: ' + JSON.stringify(data));
}).catch((err) => {
    console.error('Failed to set ScreenActiveMode 0. Cause: ' + JSON.stringify(err));
})

Orientation

屏幕方向枚举。

系统能力：  SystemCapability.WindowManager.WindowManager.Core

名称值说明
UNSPECIFIED0表示未指定屏幕方向，由系统指定。
VERTICAL1表示指定屏幕为垂直方向。
HORIZONTAL2表示指定屏幕为水平方向。
REVERSE_VERTICAL3表示指定屏幕为反向垂直方向。
REVERSE_HORIZONTAL4表示指定屏幕为反向水平方向。
SENSOR5表示屏幕方向跟随传感器方向。
SENSOR_VERTICAL6表示屏幕方向垂直跟随传感器方向。
SENSOR_HORIZONTAL7表示屏幕方向水平跟随传感器方向。

ScreenModeInfo

屏幕显示模式信息。

搜狗高速浏览器截图20240326151450.png


系统能力：  SystemCapability.WindowManager.WindowManager.Core

名称参数类型可读可写说明 HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
idnumber是是模式id，所支持的模式由具体设备分辨率和刷新率决定。
widthnumber是是屏幕的宽度。
heightnumber是是屏幕的高度。
refreshRatenumber是是屏幕的刷新率。

鸿蒙开发岗位需要掌握那些核心要领？

目前还有很多小伙伴不知道要学习哪些鸿蒙技术？不知道重点掌握哪些？为了避免学习时频繁踩坑，最终浪费大量时间的。

自己学习时必须要有一份实用的鸿蒙（Harmony NEXT）资料非常有必要。 这里我推荐，根据鸿蒙开发官网梳理与华为内部人员的分享总结出的开发文档。内容包含了：【ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战】等技术知识点。

废话就不多说了，接下来好好看下这份资料。

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。鸿蒙OpenHarmony知识←前往。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，帮助大家在技术的道路上更进一步。

其中内容包含：

《鸿蒙开发基础》鸿蒙OpenHarmony知识←前往

  1. ArkTS语言
  2. 安装DevEco Studio
  3. 运用你的第一个ArkTS应用
  4. ArkUI声明式UI开发
  5. .……

《鸿蒙开发进阶》鸿蒙OpenHarmony知识←前往

  1. Stage模型入门
  2. 网络管理
  3. 数据管理
  4. 电话服务
  5. 分布式应用开发
  6. 通知与窗口管理
  7. 多媒体技术
  8. 安全技能
  9. 任务管理
  10. WebGL
  11. 国际化开发
  12. 应用测试
  13. DFX面向未来设计
  14. 鸿蒙系统移植和裁剪定制
  15. ……

《鸿蒙开发实战》鸿蒙OpenHarmony知识←前往

  1. ArkTS实践
  2. UIAbility应用
  3. 网络案例
  4. ……

最后

鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！

爱桥代码的程序媛
关注
专栏目录
OpenHarmony以及HarmonyOS应用监听亮屏息屏
龚礼鹏的博客
05-30 133
表示设备屏幕关闭且设备处于睡眠状态的普通事件的动作。表示设备屏幕打开且设备处于交互状态的公共事件的操作。
鸿蒙组件包之 ohos.agp.windows.dialog 对话框（HarmonyOS鸿蒙开发基础知识）
iCloudEnd的博客
09-23 6623
ohos.agp.windows.dialog 提供对话框的常用方法和属性。 该包中的方法和属性可以根据需要进一步扩展。 鸿蒙支持的对话框类型 BaseDialog基本对话框 Dialog类的基类。 CommonDialog通用对话框 创建一个公共对话框。 DisplayDialog 显示对话框 在远程屏幕上显示对话框的内容。 DisplayDialog.DialogProvider 封装有关远程屏幕的信息，包括其高度，宽度，IP地址，端口和DPI中的密度。 ListDialog列表
HarmonyOS实战开发：@ohos.screen (屏幕)
2401_84194030的博客
05-29 792
本模块提供管理屏幕的一些基础能力，包括获取屏幕对象，监听屏幕变化，创建和销毁虚拟屏幕等。
OpenHarmony分布式屏幕开发参考示例
AlgoIdeas的专栏
09-03 491
分布式屏幕功能早在OpenHarmony-3.1-Release就已经发布，详情可参考官方仓库的介绍。本示例基于OpenHarmony自带的分布式屏幕相关API，并简单实现了屏幕镜像（或扩展）投屏相关应用功能。。开发者可自行基于API10开发，其中API10版本增加了停止屏幕镜像(或扩展)的API。
OpenHarmony系统解决方案 - 配置屏幕方向导致开机动画和Launcher显示异常
TiZizzz
07-16 1091
配置设备默认方向，例如修改为横屏显示，修改文件display_manager_config.xml的buildInDefaultOrientation参数值为2(Orientation::HORIZONTAL)，系统启动后开机动画横竖屏切换，Launcher显示异常。
鸿蒙开发接口图形图像：【@ohos.window (窗口)】
2301_76813281的博客
05-29 936
窗口提供管理窗口的一些基础能力，包括对当前窗口的创建、销毁、各属性设置，以及对各窗口间的管理调度。
鸿蒙开发接口图形图像：【@ohos.screenshot (屏幕截图)】
2301_76813281的博客
05-29 1402
鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！
鸿蒙开发设备管理：【@ohos.multimodalInput.keyCode (键值)】
2301_76813281的博客
07-01 679
KeyCode模块提供了按键类设备的键值。本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
HarmonyOS开发实例：【手势截屏】
2301_76813281的博客
04-11 1128
本篇Codelab基于手势处理和截屏能力，介绍了手势截屏的实现过程。根据下滑手势调用全屏截图功能。全屏截图，同时右下角有弹窗提示截图成功。根据双击手势调用区域截图功能。区域截图，通过调整选择框大小完成。
Emphasis.ScreenCapture:使用本机API的屏幕捕获库
04-11
Emphasis.ScreenCapture是一款基于C#开发的屏幕捕获库，其设计目的是利用本机API（Native API）来高效地捕获和处理屏幕内容。在Windows操作系统环境下，它能够提供灵活且性能优异的屏幕抓图功能，适用于各种软件开发...
利用QNX screen接口共享屏幕显示图像
07-08
1.QNX screen系统是一个图形框架，提供开发时图像显示功能，抽象对外统一接口，屏蔽底层硬件差异。本资源利用screen图形接口，读取显示设备的显示内容，并将其以窗口形式同步显示，并用thread实时读取原窗口变化。...
Screen_image.rar_delphi 屏幕传输_图像传输_屏幕
09-14
在Delphi编程环境中，屏幕传输和图像传输是两个重要的技术领域，主要涉及到计算机图形学、图像处理和网络通信。在标题“Screen_image.rar_delphi 屏幕传输_图像传输_屏幕”中，我们可以推断这是一个关于使用Delphi...
屏幕捕获：用于捕获屏幕或屏幕部分的功能。 使用 java.awt.robot 屏幕截图。-matlab开发
06-01
基于 Saurabh Kumar 这个优秀的屏幕截图脚本： http : //www.mathworks.com/matlabcentral/fileexchange/11363-screencapture 添加了一个函数包装器以使其更方便，还添加了能够捕获子区域而不是全屏的选项，并且...
鸿蒙轻内核A核源码分析系列七 进程管理 (2)
鸿蒙开发知识记录
09-10 1235
本文先熟悉下进程管理的文件kernel\base\core\los_process.c中的内部接口，读读代码，做些记录。
HarmonyOS Next鸿蒙扫一扫功能实现
最新发布
JohnLiu的博客
09-14 421
HarmonyOS Next鸿蒙扫一扫功能实现
HarmonyOS开发实战（ Beta5.0）蓝牙实现服务端和客户端通讯详解
weixin_55362248的博客
09-12 1291
客户端以特定服务UUID作为过滤条件扫描服务端，连接到扫描的设备后通过setCharacteristicChangeNotification接口向服务端发送‘通知心率跳动特征值变动’的请求，以便收到服务端该特征值变动的通知消息。
秒验HarmonyOS NEXT集成指南
apkkkk的博客
09-12 956
开发工具：DevEco Studio集成方式：在线集成HarmonyOS API支持：>= 12。
HarmonyOS学习(十一)——安全管理
qi85481455的博客
09-12 1046
应用只能访问有限的系统资源。但在某些情况下，应用为了扩展功能的诉求，需要访问额外的系统或者其他应用和功能。系统或应用也必须以明确的方式对外提供接口来共享其数据和功能。
R语言统计图形：split.screen与屏幕拆分
"这篇文档主要介绍了R语言中用于拆分屏幕的`split.screen()`函数，以及相关使用方法，这是在进行统计图形制作时调整多窗口显示的重要工具。文档还提到了R语言的重要贡献者谢益辉对于开源和知识分享的理念，他通过...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值