HarmonyOS 多设备短视频开发 : 10  @ObservedV2 状态管理在短视频应用中的实践
10 ObservedV2 状态管理在短视频应用中的实践一、引言HarmonyOS ArkUI V2 引入了ObservedV2、Trace、Monitor等装饰器构建了新一代响应式状态管理体系。本文分析多设备短视频项目中如何利用这些装饰器实现高效的跨组件状态管理。二、装饰器体系概览装饰器作用范围用途示例ObservedV2类标记类为可观察对象ObservedV2 class WindowInfoTrace类属性标记属性为可观察Trace public widthBp: WidthBreakpointComponentV2组件标记组件使用 V2 状态管理ComponentV2 export struct AdaptiveVideoLocal组件属性本地响应式状态Local showComment: boolean falseParam组件属性父组件传入的参数Param currentSource: stringEvent组件属性回调事件Event onStateNotify: (state) voidMonitor方法监听属性变化Monitor(currentIndex) onIndexChange()Provider组件属性提供共享状态Provider(pathStack) pathStackConsumer组件属性消费共享状态Consumer(showSideComment) showSideCommentRequire组件属性标记必填参数Require Param data: MSVDataModel[]BuilderParam组件属性Builder 插槽BuilderParam content: BuilderCallback三、状态管理架构3.1 全局状态AppStorageV2窗口信息通过AppStorageV2实现跨页面共享ObservedV2 export class WindowInfo { Trace public widthBp: WidthBreakpoint WidthBreakpoint.WIDTH_XS; Trace public windowSize: window.Size { width: 0, height: 0 }; Trace public statusBarTopVp: number 0; Trace public navigationBarBottomVp: number 0; // ... } export function getWindowInfoState(): WindowInfo { return AppStorageV2.connectWindowInfo( WindowInfo, WINDOW_INFO_STORAGE_KEY, () new WindowInfo() )!; }任何组件通过Local windowInfo: WindowInfo getWindowInfoState()获取全局窗口状态且当WindowInfo中任意Trace属性变化时自动刷新 UI。3.2 组件树状态Provider/Consumer根组件提供共享状态子组件按需消费Index.ets (Provider) ├── Provider pathStack: NavPathStack ├── Provider showSideComment: boolean ├── Provider showSideIndividual: boolean ├── Provider isDark: boolean ├── Provider subTabIndex: number ├── Provider holdingHandStatus: HoldingHandStatus │ ├── AdaptiveVideo.ets (Consumer) │ ├── Consumer showSideComment │ ├── Consumer showSideIndividual │ ├── Consumer pathStack │ ├── Provider duration │ ├── Provider currentTime │ └── Provider windowSizeWidth / windowSizeHeight │ ├── AdaptiveAVPlayer.ets (Consumer) │ ├── Consumer currentTime │ ├── Consumer duration │ └── Consumer windowSizeWidth / windowSizeHeight │ ├── IndividualByRouter.ets (Consumer) │ ├── Consumer pathStack │ └── Consumer showSideIndividual │ └── SplitComment.ets (Consumer) ├── Consumer showSideComment ├── Consumer pathStack └── Provider commentCount3.3 组件内部状态Local每个组件维护自己的 UI 状态// AdaptiveVideo.ets Local curIndex: number 0; Local angle: number 0; Local showComment: boolean false; Local currentState: media.AVPlayerState idle; Local isSeeking: boolean false; Local seekToTime: number -1; Local progressBarWidth: number 0;四、Monitor 响应式监听Monitor装饰器是 V2 的核心能力自动监听指定属性的变化并执行回调// 监听当前视频索引变化控制播放/暂停 Monitor(currentIndex) onIndexChange() { if (this.currentIndex ! this.index) { this.avPlayer?.pause(); } else { this.changePortraitVideo(); if (this.hasPrepared) this.avPlayer?.play(); else this.initAVPlayer(); } } // 监听窗口尺寸变化重新计算视频沉浸式布局 Monitor(windowSizeWidth, windowSizeHeight) onWindowSizeChange() { this.changePortraitVideo(); } // 监听进度条拖拽 Monitor(seekToTime) onSeekToTimeChange() { if (this.seekToTime 0 this.avPlayer this.canSeek()) { this.avPlayer.seek(Math.floor(this.seekToTime), SeekMode.SEEK_CLOSEST); } }五、Event 回调机制Event用于子组件向父组件通信// 子组件定义事件 Event onStateNotify: (state: media.AVPlayerState) void () {}; // 子组件触发 this.onStateNotify(state); // 父组件传入回调 AdaptiveAVPlayer({ onStateNotify: (state: media.AVPlayerState) { this.currentState state; } })六、Param 参数传递父组件通过Param向子组件传递数据支持Require标记必填参数// 子组件 Require Param data: MSVDataModel[]; Param index: number 0; Param useFloating: boolean true; // 父组件使用 MSVTabs({ data: this.data, index: 0, useFloating: false })七、数据流总结AppStorageV2 (全局) ──→ WindowInfo (窗口状态) │ ▼ Provider (根组件) ──→ pathStack, showSideComment, isDark, ... │ ▼ Consumer (子组件) ──→ 消费共享状态 │ ▼ Local (组件内部) ──→ UI 状态 │ ▼ Monitor ──→ 响应式监听执行业务逻辑 │ ▼ Event ──→ 子→父 回调通知八、最佳实践全局状态最小化只将真正需要跨组件共享的状态放入AppStorageV2或ProviderLocal 优先组件内部状态优先使用Local避免过度共享Monitor 代替手动监听利用Monitor自动监听属性变化减少手动事件注册和清理Event 代替回调参数子组件向父组件通信使用Event保持类型安全避免循环依赖Provider/Consumer的 key 值命名要全局唯一避免命名冲突

相关新闻

HarmonyOS 多设备短视频开发 : 09  多 HAP 包管理:一次开发多端部署实践

HarmonyOS 多设备短视频开发 : 09 多 HAP 包管理:一次开发多端部署实践

09 多 HAP 包管理:一次开发多端部署实践一、引言HarmonyOS 的多 HAP 机制允许应用按设备形态分发不同的安装包。本项目中,手机/平板、电脑、智慧屏、手表分别使用独立的 HAP 包,共享同一套业务代码,实现"一次开发、多端部署…

2026/11/18 10:46:01 阅读更多 →
HarmonyOS 多设备短视频开发 : 08 — 多设备手势交互的差异化处理策略

HarmonyOS 多设备短视频开发 : 08 — 多设备手势交互的差异化处理策略

08 — 多设备手势交互的差异化处理策略一、引言多设备短视频应用中,手势交互是用户体验的关键。从手机触摸到智慧屏遥控器,不同设备需要不同的手势策略。本文分析项目中的手势识别、冲突处理和设备差异化实现。二、手势识别类型2.1 TapGesture&#xff0…

2026/11/3 6:24:35 阅读更多 →
VMware 25H2汉化全攻略:从安装到界面切换一篇搞定

VMware 25H2汉化全攻略:从安装到界面切换一篇搞定

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/6 10:04:10 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/17 8:22:52 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/17 12:46:04 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/17 12:46:04 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/17 11:26:33 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/17 12:46:05 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/17 12:46:05 阅读更多 →

日新闻

周新闻

月新闻