先看问题

这篇只讲一个点：3DGS 光照一致性。我不会把它当成一个概念名词过一遍，而是按开发时真正会遇到的问题来拆：3DGS 采集不是帧数越多越好，光照变化太大时，更多帧反而会污染重建。

我这次按 HarmonyOS 7.0 / API 26 的口径写，重点看三个问题：问题怎么发生、怎么复现、怎么修，最后怎么封装成下一次能直接复用的检查动作。

版本口径和适用范围

问题为什么会发生

很多 HarmonyOS 新能力看起来是一个开关，实际落到工程里会变成一组协作关系。页面状态、设备能力、窗口形态、后台任务和用户操作节奏都可能影响结果。

3DGS 光照一致性 这里最容易踩的坑是：采到就加入队列。这种写法短期能跑通，换设备、换窗口或者遇到弱网以后就会暴露问题。我的处理方式是：先做光照差异门禁，把容易变化的条件放到入口处先判断，再让后面的代码只处理确定状态。

案例一：最小复现

先写一个能复现问题的版本。这个版本故意保留常见错误，让问题能被看见。

typeCheckResult={ok:booleanreason:stringcost:number}classFeatureProbe{privaterunning=falseprivatelastVersion=0asyncrunUnsafe(input:string):Promise<CheckResult>{conststart=Date.now()this.running=true// 问题点：没有版本号，也没有取消保护。// 页面快速切换、窗口变化或用户重复触发时，旧结果可能覆盖新结果。awaitnewPromise<void>((resolve)=>setTimeout(resolve,180))return{ok:input.length>0,reason:input.length>0?'ready':'empty input',cost:Date.now()-start,}}asyncrunSafe(input:string):Promise<CheckResult>{conststart=Date.now()constversion=++this.lastVersionthis.running=trueawaitnewPromise<void>((resolve)=>setTimeout(resolve,180))if(version!==this.lastVersion){return{ok:false,reason:'stale result ignored',cost:Date.now()-start}}if(!input.trim()){return{ok:false,reason:'input is empty',cost:Date.now()-start}}return{ok:true,reason:'accepted by guarded path',cost:Date.now()-start}}}

这个例子故意写得比较小，但它对应的不是玩具问题。真实页面里，3DGS 光照一致性 经常会被窗口变化、设备能力变化、页面返回、蓝牙切换、后台任务回调这些条件打断。没有版本号和取消保护，旧回调就会把新状态覆盖掉。

案例二：加上边界和回退

第二个例子把判断提前。入口先做能力、状态和节奏检查，后面的实现只关心已经被确认过的条件。

typeRuntimeState={apiLevel:numberdeviceReady:booleanwindowStable:booleanbatteryLow:booleanrequestId:string}typeDecision={mode:'full'|'fallback'|'blocked'reason:string}functiondecideFeatureMode(state:RuntimeState):Decision{if(state.apiLevel<26){return{mode:'fallback',reason:'API level below 26'}}if(!state.deviceReady){return{mode:'blocked',reason:'device capability is not ready'}}if(!state.windowStable){return{mode:'fallback',reason:'window is changing'}}if(state.batteryLow){return{mode:'fallback',reason:'battery is low, use light path'}}return{mode:'full',reason:'full feature path allowed'}}functionbuildLog(state:RuntimeState,decision:Decision):string{return['feature=three-dgs-light','api='+state.apiLevel,'request='+state.requestId,'mode='+decision.mode,'reason='+decision.reason,].join(' | ')}conststate:RuntimeState={apiLevel:26,deviceReady:true,windowStable:false,batteryLow:false,requestId:'case-001',}constdecision=decideFeatureMode(state)console.info(buildLog(state,decision))

这段代码的重点不是语法，而是判断顺序。API 版本、设备能力、窗口稳定性和电量状态最好在入口处就收口。这样后面的页面代码不会到处散落 if，也更容易写单测和日志。

方案对比

我更建议用第三种。HarmonyOS 7.0 / API 26 的新能力越来越多，工程里真正贵的不是写一次调用，而是以后出问题时能不能快速知道是哪一层坏了。

验证方式

我会按下面几条看结果，而不是只看页面能不能打开：

• API 版本低于 26 时，必须走 fallback，不允许继续 full path。
• 设备能力未就绪时，必须给出明确 reason，不能静默失败。
• 窗口拖拽或形态变化中，必须避免重复刷新。
• 低电量或高负载时，必须保留轻量路径。
• 日志里要能看到 requestId、mode 和 reason，方便回查。

示例日志应该类似这样：

feature=three-dgs-light | api=26 | request=case-001 | mode=fallback | reason=window is changing

可以封装成什么

我会把这类逻辑收成一个小的 adapter，而不是塞进页面组件里。

exportclassHarmonyFeatureGuard{constructor(privatereadonlyapiLevel:number){}canUseApi26Feature(deviceReady:boolean,windowStable:boolean):Decision{returndecideFeatureMode({apiLevel:this.apiLevel,deviceReady,windowStable,batteryLow:false,requestId:'guard-check',})}}

这样做的收益很直接：页面只管展示和交互，guard 只管能力边界。以后换成折叠屏、平板、鸿蒙电脑或者加新的设备状态，也不用把页面代码全部翻一遍。

最后留一个检查清单

• 先确认 HarmonyOS 7.0 / API 26 的能力边界，再写调用代码。
• 先复现失败场景，再谈优化。
• 入口层记录 reason，不要只返回 true 或 false。
• 降级路径要能解释，不要让用户觉得功能失灵。
• 多设备、多窗口、低电量、弱网至少选两个场景压一下。

如果你也遇到 3DGS 光照一致性 相关问题，可以把设备类型、API 版本和失败日志贴出来，很多问题看日志里的 mode 和 reason 就能先排掉一半。