
基于ArkTS语言的OpenHarmony APP应用开发:图片处理 原创
1、程序介绍
本案例使用TextArea实现多文本输入,使用mediaLibrary实现在相册中获取图片,使用image生成pixelMap,使用pixelMap的scale(),crop(),rotate()接口实现对图片的缩放,裁剪,旋转功能。
案例说明:
-
发表评价页面点击添加图片/照片,页面跳转到图片选择页面。
-
进入图片选择页面后,选择需要显示的图片,最多选择6张图片。
-
选中图片后点击下一步,页面会跳转到图片编辑页面,点击缩放,页面会显示缩小,放大按钮,点击按钮,可对图片进行缩小,放大操作。点击裁剪,页面会跳出裁剪比例,点击想要裁剪的比例可以对图片进行裁剪。点击旋转可对图片进行旋转。
-
图片编辑完成后,点击确认,页面会跳转到发表评价页面,显示相关照片。点击添加图片/照片可以对图片进行重新选择。
-
点击返回按钮,退出应用。
本案例已在OpenHarmony凌蒙派-RK3568开发板验证通过,具体代码可参考:https://gitee.com/Lockzhiner-Electronics/lockzhiner-rk3568-openharmony/tree/master/samples/d07_Image
API接口:9
2、知识准备
2.1、TextArea
多行文本输入框组件,当输入的文本内容超过组件宽度时会自动换行显示。
其中,参数定义如下:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
placeholder | ResourceStr | 否 | 设置无输入时的提示文本 |
text | ResourceStr | 否 | 设置输入框当前的文本内容 |
controller | TextAreaController | 否 | 设置TextArea控制器 |
其中,属性可支持如下:
名称 | 参数类型 | 描述 |
---|---|---|
placeholderColor | ResourceColor | 设置placeholder文本颜色 |
placeholderFont | Font | 设置plaoceholder文本样式 |
textAlign | TextAlign | 设置文本在输入框中的水平对齐式 默认值:TextAlign.Start |
caretColor | ResourceColor | 设置输入框光标颜色 |
inputFilter | { value: ResourceStr, error?: (value: string) => void } |
通过正则表达式设置输入过滤器。匹配表达式的输入允许显示,不匹配的输入将被过滤。仅支持单个字符匹配,不支持字符串匹配。<br/>- value:设置正则表达式。<br/>- error:正则匹配失败时,返回被过滤的内容。 |
copyOption | CopyOptions | 设置输入的文本是否可复制。<br/>设置CopyOptions.None时,当前TextArea中的文字无法被复制或剪切,仅支持粘贴。 |
2.2、mediaquery
ohos.mediaquery提供媒体查询,提供根据不同媒体类型定义不同的样式。
2.2.1、导入模块
2.2.2、 mediaquery.matchMediaSync
设置媒体查询的查询条件,并返回对应的监听句柄。
参数定义如下所示:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
condition | string | 是 | 媒体事件的匹配事件 |
返回值定义如下所示:
类型 | 说明 |
---|---|
MediaQueryListener | 媒体事件监听句柄,用于注册和销毁监听回调 |
2.2.3、MediaQueryListener
媒体查询的句柄,并包含了申请句柄时的首次查询结果。
系统能力: SystemCapability.ArkUI.ArkUI.Full
(1)属性
名称 | 类型 | 可读 | 可写 | 说明 |
---|---|---|---|---|
matches | boolean | 是 | 否 | 是否符合匹配条件 |
media | string | 是 | 否 | 媒体事件的匹配条件 |
(2)on函数
通过句柄向对应的查询条件注册回调,当媒体属性发生变更时会触发该回调。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 必须填写字符串change |
callback | Callback<MediaQueryResult> | 是 | 向媒体查询注册的回调 |
(3)off函数
通过句柄向对应的查询条件去注册回调,当媒体属性发生变更时不在触发指定的回调。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 必须填写字符串change |
callback | Callback<MediaQueryResult> | 否 | 需要去注册的回调,如果参数缺省则去注册该句柄下所有的回调 |
2.2.4、MediaQueryResult
用于执行媒体查询操作。
系统能力: SystemCapability.ArkUI.ArkUI.Full
(1)属性
名称 | 类型 | 可读 | 可写 | 说明 |
---|---|---|---|---|
matches | boolean | 是 | 否 | 是否符合匹配条件 |
media | string | 是 | 否 | 媒体事件的匹配条件 |
2.3、mediaLibrary
MediaLibrary支持能力列举如下:
- 查询音频、视频和图片文件元数据信息
- 查询图片和视频相册
- 媒体文件操作如创建、重命名、拷贝和删除
- 相册操作如创建、重命名和删除
MediaLibrary整体框架,如下所示:
详细请参考:官方文档
2.4、Grid
网格容器,由“行”和“列”分割的单元格所组成,通过指定“项目”所在的单元格做出各种各样的布局。
详细请参考:官方文档
2.5、@ohos.multimedia.image
本模块提供图片处理效果,包括通过属性创建PixelMap、读取图像像素数据、读取区域内的图片数据等。
详细请参考:官方文档
2.6、@ohos.router
本模块提供通过不同的url访问不同的页面,包括跳转到应用内的指定页面、用应用内的某个页面替换当前页面、返回上一页面或指定的页面等。
详细请参考:官方文档
3、程序解析
3.1、申请设备权限
配置文件module.json5中声明权限,申请应用读取、写入用户外部存储中的媒体文件信息以及允许应用访问用户媒体文件中的地理位置信息。
3.2、Index.ets
首先,声明1个pixelMaps数组,用于存放照片或视频。
注意:@StorageLink('pixelMaps')
表明通过使用@StorageLink(key)装饰的状态变量,与AppStorage建立双向数据绑定。
其次,在build()
调用之前运行aboutToAppear()
,负责获取AppStorage的pixelMaps属性,然后往当前页传入isShowCamera
参数。
最后,build()
显示整个页面。
其中,已选图片通过Grid和GridItem控件排列显示。
3.3、ChoicePhotos.ets
该页面为选择照片页面。该页面通过调用ChoicePhoto()
显示页面。
ChoicePhoto()
主要负责显示照片视频以及添加等功能的界面。
首先,声明1个MediaLibrary类对象和监听句柄listener,用于查询音频、视频和图片文件元数据信息。
其次,调用build()之前做初始化工作,主要是开启监听句柄listener的change事件,并获取设备端保存的图片资源。
其中,getFileAssetsFromType()获取设备端所有的图片或视频的文件信息。
再次,使用Grid和GridItem控件显示图片或视频。
最后,定义1个按键事件。一旦选中某个图片,可进入图片编辑页面。
4、项目编译
4.1、打开项目
打开DevEco Studio,再打开自定义通知项目。
4.2、编译程序
点击菜单栏上的“Build” -> “Rebuild Project”。如果出现无法编译,则注意查看Event Log界面。如下所示:
点击Run 'npm install'
,让DevEco Studio安装相关依赖包。
重新点击菜单栏上的“Build” -> “Rebuild Project”。出现如下错误:
点击上图红色框部分,安装相关服务。
重新点击菜单栏上的“Build” -> “Rebuild Project”,编译成功。
4.3、安装程序
点击“entry”按钮,将项目程序安装到设备端。如下图所示:
如果出现下述报错,表示无法安装。如图所示:
点击上图红色框的蓝色字体,弹出"Project Structure"对话框,点击"Apply",再点击"OK"。如图所示:
重新点击“entry”按钮,将项目程序安装到设备端。
5、运行结果
