Flutter 鴻蒙化實(shí)戰(zhàn)volume_controller 適配 OpenHarmony## 前言隨著鴻蒙生態(tài)的快速發(fā)展越來(lái)越多的 Flutter 應(yīng)用需要適配 OpenHarmony 平臺(tái)。但生態(tài)早期大量常用三方庫(kù)只有 Android / iOS 實(shí)現(xiàn)鴻蒙側(cè)只能自己造輪子。為了解決這個(gè)問(wèn)題CPF-Flutter 社區(qū)對(duì)一批高頻使用的 Flutter 三方庫(kù)做了 OpenHarmony 平臺(tái)適配統(tǒng)一托管在 GitCode 的CPF-Flutter 組織 下全部通過(guò) TAG 版本隔離、配套門(mén)禁編譯驗(yàn)證開(kāi)箱即用。本篇是系列文章之一主角是volume_controller—— 系統(tǒng)音量控制插件。## volume_controller 是什么volume_controller原庫(kù) 3.4.0用于控制系統(tǒng)媒體音量1.讀取/設(shè)置getVolume/setVolume讀取 / 設(shè)置音量2.靜音isMuted/setMute判斷 / 設(shè)置靜音3.監(jiān)聽(tīng)addListener監(jiān)聽(tīng)音量變化4.系統(tǒng) UIshowSystemUI顯示系統(tǒng)音量條。## 適配情況| Flutter 框架版本 | TAG 名稱(chēng) | 分支名 || — | — | — || 3.22 | 3.4.0-ohos.1.0.1 | master || 3.27 | 3.4.0-ohos.1.0.1 | master || 3.35 | 3.4.0-ohos.1.0.1 | master |## 快速接入在 pubspec.yaml 中添加 git 依賴(lài)yamldependencies: volume_controller: git: url: https://gitcode.com/CPF-Flutter/fluttertpc_volume_controller.git # 按你的 Flutter 框架版本從上方映射表選擇對(duì)應(yīng) TAG ref: 3.4.0-ohos.1.0.1執(zhí)行bashflutter pub get## 使用示例dartimport package:volume_controller/volume_controller.dart;// 讀取當(dāng)前音量final vol await VolumeController.instance.getVolume();// 設(shè)置音量await VolumeController.instance.setVolume(0.5);// 設(shè)置靜音await VolumeController.instance.setMute(true);## API 支持一覽| API | 說(shuō)明 || — | — || getVolume / setVolume | 讀取 / 設(shè)置音量 || isMuted / setMute | 判斷 / 設(shè)置靜音 || addListener | 監(jiān)聽(tīng)音量變化 || showSystemUI | 顯示系統(tǒng)音量條 | [TIP] 本庫(kù)鴻蒙版與上游 API 對(duì)齊接入方式與 iOS / Android 一致。## 倉(cāng)庫(kù)地址- OpenHarmony 適配倉(cāng)庫(kù)https://gitcode.com/CPF-Flutter/fluttertpc_volume_controller- 使用問(wèn)題反饋請(qǐng)到 CPF-Flutter 社區(qū) Issues 提交問(wèn)題社區(qū)統(tǒng)一收集跟進(jìn)本倉(cāng)庫(kù) Issues 區(qū)亦可。## 系列預(yù)告截至目前CPF-Flutter 社區(qū)已完成250 個(gè)Flutter 三方庫(kù)的 OpenHarmony 平臺(tái)適配覆蓋權(quán)限管理、UI 組件、設(shè)備信息、位置服務(wù)、媒體處理、網(wǎng)絡(luò)、支付等多個(gè)領(lǐng)域完整的適配清單含每個(gè)庫(kù)的版本映射表見(jiàn)-適配總覽文檔https://gitcode.com/CPF-Flutter/docs/blob/main/ThirdpartyLibrarites.md-倉(cāng)庫(kù)組織https://gitcode.com/CPF-Flutter本系列后續(xù)會(huì)陸續(xù)挑選高頻庫(kù)展開(kāi)講解比如底部選擇器bottom_picker、應(yīng)用升級(jí)flutter_app_update、日期選擇calendar_date_picker2等。如果你的 Flutter 應(yīng)用正在計(jì)劃適配鴻蒙歡迎關(guān)注 CPF-Flutter 組織也歡迎參與共建。