HarmonyOS開發(fā)指導(dǎo)類文檔更新速遞(上)

伴隨著HarmonyOS 5.0.0 Release版本的發(fā)布，HarmonyOS官網(wǎng)文檔也帶來(lái)了不少上新內(nèi)容。本期HarmonyOS NEXT開發(fā)者資料直通車將從文檔更新角度為開發(fā)者推薦應(yīng)用框架、媒體相關(guān)能力新增、優(yōu)化文檔，方便開發(fā)者更加高效使用文檔。

ArkUI（方舟UI框架）

ArkUI（方舟UI框架）是一個(gè)簡(jiǎn)潔、高性能、支持跨設(shè)備的UI框架，提供了豐富的應(yīng)用界面開發(fā)所需能力。

· 新增使用彈窗：介紹各類彈窗的使用場(chǎng)景與實(shí)現(xiàn)方法，重點(diǎn)說(shuō)明自定義彈出框和各類固定樣式彈出框的構(gòu)建方式。

· 新增自定義擴(kuò)展：介紹如何通過與UI分離的方式，對(duì)已有UI組件的屬性、手勢(shì)、內(nèi)容進(jìn)行擴(kuò)展修改。AttributeModifier相比于@Styles和@Extend，可以通過Modifier對(duì)象更靈活的動(dòng)態(tài)修改屬性，同時(shí)引入AttributeUpdater能力使得開發(fā)者可自定義更新策略，進(jìn)一步提高屬性更新的性能。

· 新增屬性字符串：介紹通過屬性字符StyledString/MutableStyledString多樣化更改文本的方式。

· 新增使用鏡像能力、支持適老化：介紹鏡像能力的使用場(chǎng)景與默認(rèn)支持的組件，說(shuō)明適老化的使用約束與觸發(fā)方式等。

· 新增粒子動(dòng)畫、幀動(dòng)畫：粒子動(dòng)畫介紹粒子的基本組成元素，說(shuō)明粒子在顏色、透明度、大小等維度變化的實(shí)現(xiàn)方法。幀動(dòng)畫說(shuō)明如何使用@ohos.animator實(shí)現(xiàn)動(dòng)畫效果，其相比于屬性動(dòng)畫，可感知?jiǎng)赢嫷倪^程，實(shí)時(shí)修改UI側(cè)的值，具有事件可實(shí)時(shí)響應(yīng)、可暫停的優(yōu)點(diǎn)。

· 使用UI上下文接口操作界面（UIContext）：介紹在Stage模型下，如何獲取當(dāng)前組件所在的UIContext，并使用UIContext中對(duì)應(yīng)的接口獲取與實(shí)例綁定的對(duì)象。解決FA模型下開放的ArkUI全局接口，在調(diào)用時(shí)無(wú)法明確運(yùn)行在哪個(gè)實(shí)例里，語(yǔ)義不明確的問題。

· 優(yōu)化自定義渲染(XComponent)文檔結(jié)構(gòu)：分別介紹NativeXComponent和ArkTS XComponent的使用場(chǎng)景，為開發(fā)者提供更完整的使用指導(dǎo)與相關(guān)生命周期的說(shuō)明。

相關(guān)參考文檔：

·新增使用彈窗：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-dialog-overview-V5

·新增自定義擴(kuò)展：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-user-defined-modifier-V5

·新增屬性字符串：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-styled-string-V5

·新增使用鏡像能力、支持適老化：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-mirroring-display-V5

·新增粒子動(dòng)畫、幀動(dòng)畫：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-animator-V5

·使用UI上下文接口操作界面（UIContext）：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-global-interface-V5

·優(yōu)化自定義渲染 (XComponent)文檔結(jié)構(gòu)：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/napi-xcomponent-guidelines-V5 ArkWeb（方舟Web）

提供了Web組件，用于在應(yīng)用程序中顯示W(wǎng)eb頁(yè)面內(nèi)容。在HarmonyOS 5.0.0 Release版本，主要新增/優(yōu)化了如下文檔。

·豐富網(wǎng)頁(yè)端的實(shí)現(xiàn)場(chǎng)景：使用運(yùn)動(dòng)和方向傳感器、Web組件在不同的窗口間遷移、網(wǎng)頁(yè)中安全區(qū)域計(jì)算和避讓適配、使用Web組件的廣告過濾功能和Web前進(jìn)后退緩存等章節(jié)。

·新增應(yīng)用側(cè)與前端頁(yè)面的相互調(diào)用(C/C++)、建立應(yīng)用側(cè)與前端頁(yè)面數(shù)據(jù)通道(C/C++)：解決了ArkTS環(huán)境的冗余切換問題。同時(shí)允許回調(diào)在非UI線程運(yùn)行，避免造成UI阻塞。

·優(yōu)化同層渲染章節(jié)：補(bǔ)充同層渲染在Web網(wǎng)頁(yè)和三方UI框架下的使用場(chǎng)景，說(shuō)明整體架構(gòu)邏輯與相關(guān)規(guī)格約束，并提供更豐富的場(chǎng)景示例。

相關(guān)文檔參考鏈接：

· 使用運(yùn)動(dòng)和方向傳感器監(jiān)測(cè)設(shè)備狀態(tài)：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/web-sensor-V5

· Web組件在不同的窗口間遷移：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/web-component-migrate-V5

· 網(wǎng)頁(yè)中安全區(qū)域計(jì)算和避讓適配：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/web-safe-area-insets-V5

· 使用Web組件的廣告過濾功能：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/web-adsblock-V5

· Web前進(jìn)后退緩存：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/web-set-back-forward-cache-V5

·新增應(yīng)用側(cè)與前端頁(yè)面的相互調(diào)用(C/C++)：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkweb-ndk-jsbridge-V5

· 建立應(yīng)用側(cè)與前端頁(yè)面數(shù)據(jù)通道(C/C++)：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkweb-ndk-page-data-channel-V5

· 同層渲染：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/web-same-layer-V5

Audio Kit

AudioKit優(yōu)化了音頻焦點(diǎn)和音頻會(huì)話的開發(fā)指導(dǎo)，提供常見的音頻流適用場(chǎng)景及對(duì)應(yīng)的音頻焦點(diǎn)策略介紹，幫助開發(fā)者為音頻選擇恰當(dāng)?shù)牧黝愋?，從而妥善地管理音頻焦點(diǎn)，提升用戶的音頻體驗(yàn)。

·使用合適的音頻流類型：

音頻流類型是定義音頻數(shù)據(jù)播放和錄制方式的關(guān)鍵屬性。音頻流類型對(duì)音量控制、音頻焦點(diǎn)管理以及輸入/輸出設(shè)備的選擇具有決定性影響。為了確保音頻行為符合預(yù)期并提供優(yōu)質(zhì)的用戶體驗(yàn)，應(yīng)用開發(fā)者應(yīng)根據(jù)具體業(yè)務(wù)場(chǎng)景和實(shí)際需求，為音頻選擇恰當(dāng)?shù)牧黝愋汀?/p>

通過文檔，開發(fā)者可以學(xué)習(xí)常用的音頻流類型及其適用場(chǎng)景，了解不同流類型對(duì)音頻業(yè)務(wù)的影響。同時(shí)，文檔將指導(dǎo)開發(fā)者在實(shí)際開發(fā)時(shí)應(yīng)當(dāng)如何設(shè)置音頻流類型。

·管理音頻焦點(diǎn)：

在應(yīng)用播放或錄制聲音時(shí)，常出現(xiàn)與其他音頻流的并發(fā)或中斷情況，這對(duì)用戶體驗(yàn)構(gòu)成顯著影響。例如，當(dāng)應(yīng)用啟動(dòng)視頻播放時(shí)，若后臺(tái)正在播放音樂，用戶會(huì)期望音樂能自動(dòng)暫停，以確保視頻音頻優(yōu)先播放，這正是音頻焦點(diǎn)功能的體現(xiàn)。

通過文檔，開發(fā)者可以了解系統(tǒng)的音頻焦點(diǎn)策略，學(xué)習(xí)如何申請(qǐng)、釋放音頻焦點(diǎn)，以及應(yīng)對(duì)焦點(diǎn)變化的方法，從而妥善地管理音頻焦點(diǎn)，提升用戶的音頻體驗(yàn)。

除此以外，系統(tǒng)提供了音頻會(huì)話（AudioSession）機(jī)制，允許應(yīng)用自定義其音頻流的焦點(diǎn)策略。在系統(tǒng)進(jìn)行焦點(diǎn)管理時(shí)，只要條件允許，本應(yīng)用的所有音頻流將優(yōu)先遵循這一策略。

相關(guān)文檔參考鏈接：

·使用合適的音頻流類型：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/using-right-streamusage-and-sourcetype-V5

·管理音頻焦點(diǎn)：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/audio-playback-concurrency-V5