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

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

ArkUI（方舟UI框架）

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

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

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

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

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

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

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

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

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

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

·新增自定義擴展：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

·新增粒子動畫、幀動畫：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頁面內(nèi)容。在HarmonyOS 5.0.0 Release版本，主要新增/優(yōu)化了如下文檔。

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

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

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

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

· 使用運動和方向傳感器監(jiān)測設(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)頁中安全區(qū)域計算和避讓適配：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è)與前端頁面的相互調(diào)用(C/C++)：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkweb-ndk-jsbridge-V5

· 建立應(yīng)用側(cè)與前端頁面數(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)化了音頻焦點和音頻會話的開發(fā)指導(dǎo)，提供常見的音頻流適用場景及對應(yīng)的音頻焦點策略介紹，幫助開發(fā)者為音頻選擇恰當(dāng)?shù)牧黝愋?，從而妥善地管理音頻焦點，提升用戶的音頻體驗。

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

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

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

·管理音頻焦點：

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

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

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

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

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

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