下載鏈接【免費】牛馬投屏軟件一款基于**FlutterPlatinumDLL**的Windows桌面投屏接收端支持DLNA協議資源-CSDN下載界面圖摘 要NiuMa 投屏是一款運行在 Windows 桌面上的跨協議投屏接收軟件同時支持 DLNA、AirPlay、Miracast 三大主流投屏協議。軟件采用Flutter 渲染 UI 原生 C DLL 解碼視頻的混合架構把面向用戶的交互層與重資源的協議棧 / 解碼層解耦既保留了 Flutter 高效的開發體驗又拿到了原生層對硬解、SSDP 廣播、HWND 視頻層等 Win32 能力的完全控制。本文從項目背景、痛點分析、技術架構、關鍵源碼解析、創新點、典型應用等維度系統性地介紹 NiuMa 投屏的設計與實現為 Flutter 桌面混合開發、DLNA/AirPlay 投屏協議研究、單 DLL 動態加載等方向提供一份可直接復用的工程參考。關鍵詞FlutterDLNAAirPlayMiracastUPnPPlatinum SDKFFmpegMethodChannel原生混合開發動態加載 DLL視頻硬解Flutter Windows 桌面一、項目背景與行業痛點隨著手機視頻、網課、直播的爆發式增長把手機畫面投到電腦大屏成為高頻剛需。然而現有方案普遍存在以下痛點1. 商業投屏軟件強推會員、廣告、捆綁安裝——樂播投屏、AirDroid 等免費版頻繁彈窗、限速、限清晰度專業版動輒 30~60 元/月電腦端要么被強塞全家桶要么強制綁定賬號體系。2. 系統自帶連接功能對國內 App 兼容性差——Windows 自帶的投影到此電腦僅支持 Miracast而國內主流視頻 AppB 站、愛優騰、抖音幾乎只走 DLNA / AirPlay根本搜不到設備。3. 瀏覽器投屏對編碼格式挑剔——Chrome / Edge 的 Tab Cast 走 WebRTC4K HEVC / HDR 內容經常卡頓、掉幀、色彩異常本地播放器愛奇藝、騰訊視頻電腦版又不支持反向推流。4. 跨平臺開發者沒有可參考的工程模板——DLNA / AirPlay / Miracast 三協議的開源實現寥寥無幾想在 Flutter 桌面端做一個完整接收端幾乎只能從 Platinum SDK 文檔讀起缺少Dart ? Native 橋接 SSDP 廣播 硬解渲染的整套工程范例。5. 投屏體驗被手機綁架——來電、通知、息屏、切換 App 都會讓投屏中斷長時間看視頻手機發燙、電量告急直播、網課、追劇場景極度影響體驗。NiuMa 投屏正是為了解決上述痛點而誕生完全開源、零廣告、零會員三協議合一在電腦端原生硬解視頻手機只負責推流提供清晰的工程模板供學習與二次開發。二、NiuMa 投屏是什么NiuMa 投屏niuma_mirror是一款 Windows 桌面投屏接收端支持 DLNA DMR、AirPlay、Miracast 三種主流投屏協議可同時啟用。它把手機、平板等設備上的視頻、音頻、圖片畫面無線推送到電腦端播放幾乎不消耗手機電量也不會被來電、通知、息屏打斷。軟件提供完整的投屏體驗設備發現、媒體推送、硬解播放、錄制、下載、歷史記錄、媒體信息查看以及強制免責聲明。核心定位個人用戶免費、純凈的大屏投屏工具追劇、上網課、看直播技術愛好者研究 DLNA / AirPlay / Miracast 協議棧的最佳工程范例開發者Flutter 桌面混合開發、單 DLL 動態加載、原生 HWND 視頻層的模板三、核心功能與作用【三協議合一】同時啟用 DLNA DMR、AirPlay 接收、Miracast 接收端覆蓋 iOS / Android / Windows / Mac 全平臺推送方【原生硬解播放】H.264 / H.265 / AAC 全硬解D3D11VA / DXVA2CPU 占用低、4K 流暢不卡頓硬解策略可按需切換 AUTO/D3D11VA/DXVA2/SOFT【零手機負擔】視頻在電腦端原生解碼手機只負責推流可鎖屏、來電、聊天、看視頻均不中斷【自適應碼率 / 分辨率】根據網絡抖動自動調整緩沖檔位LOW/NORMAL/HIGH/MAX保證流暢優先【投屏錄像】一鍵把投屏內容保存為本地 MP4 / MKV文件名自動清洗、路徑自動去重【媒體下載】把推流中的流媒體緩存到本地format 可選 mp4 / mkv支持取消、進度顯示、錯誤重試【歷史記錄】所有投屏會話、錄像文件、下載文件集中管理可一鍵打開文件、清空記錄、復制文件路徑【媒體信息面板】一鍵查看推送端身份IP / 端口 / UA / 設備簽名 媒體詳情容器 / 視頻編解碼 / 分辨率 / 幀率 / 音頻參數【強制免責聲明】每次啟動強制彈出免責聲明需閱讀并同意才能進入主窗口符合合規與軟件著作權要求【暗色主題 UI】深色面板 琥珀色高亮 藍色主操作長時間使用不刺眼原生 dark UI工程級交互細節四、技術架構NiuMa 投屏采用Flutter 渲染 UI 原生 C DLL 解碼視頻的分層混合架構UI 交互、設置面板、狀態欄全部走 Flutter視頻解碼、SSDP 發現、UPnP 協議、媒體信息解析全部走 platinum_sink.dll基于 Platinum UPnP SDK FFmpeg。Flutter 與 DLL 之間通過 MethodChannel EventChannel 雙向通信。4.1 整體架構圖┌────────────────────────────────────────┐│ Flutter UI (Dart) ││ - MaterialApp / AppShell ││ - 標題欄 / 狀態欄 / 投屏區 ││ - 設置 / 媒體信息彈窗 / 錄像管理 │└────────────┬───────────────────────────┘│ MethodChannel / EventChannel┌────────────▼───────────────────────────┐│ platinum_sink.dll (C) ││ - Platinum UPnP SDK ││ - FFmpeg (H.264 / H.265 / AAC) ││ - SSDP 發現 / 主動廣播 / 狀態機 ││ - 原生 HWND 視頻渲染 │└────────────────────────────────────────┘4.2 技術棧總覽● UI 層Flutter 3.x / Dart 3.x、MaterialApp、Custom Widgets、ValueNotifier避免不必要 rebuild● 窗口管理bitsdojo_window無邊框 / 最小尺寸限制 / 最大化 / 全屏 / 拖動● 平臺橋MethodChannel命令調用 EventChannel事件流推送● 協議棧Platinum UPnP SDKDLNA / AirPlay / Miracast 三協議● 解碼FFmpegH.264 / H.265 / AAC自適應 D3D11VA / DXVA2 / Soft● 設備發現SSDP組播 M-SEARCH 單播 NOTIFY主動廣播 max-age● 網絡監聽netsh wlan show interfacesWiFi 狀態、SSID、信號強度● 系統集成Win32 HWND 視頻層WS_POPUP蓋在 Flutter UI 之上● 打包單 platinum_sink.dll無 .libLoadLibrary 動態加載● 構建CMake MSVC Flutter Windows 構建系統4.3 模塊劃分項目目錄結構清晰按主題 服務 組件三層組織lib/├── main.dart 入口 AppShell 主殼 免責聲明觸發├── theme.dart 主題色 / 字體 / 文字樣式集中管理├── services/ 原生橋接層不依賴 UI│ ├── platinum_sink.dart DLL 通信封裝Method/EventChannel│ ├── wifi_monitor.dart WiFi 狀態探測netsh│ ├── app_settings.dart 設置持久化SharedPreferences│ └── media_info_parser.dart 媒體信息 JSON 解析└── widgets/ UI 組件按業務拆分├── app_title_bar.dart 標題欄含作者 QQ 徽章├── status_bar.dart 底部狀態欄├── screen_area.dart 投屏區與原生 HWND 邊界同步├── player_control_bar.dart 播放器控制條├── media_info_dialog.dart 媒體信息彈窗├── records_panel.dart 歷史記錄面板├── settings_window.dart 設置窗口├── disclaimer_dialog.dart 免責聲明彈窗└── window_control_button.dart 窗口控制按鈕五、關鍵模塊源碼解析5.1 平臺橋platinum_sink.dart這是 Flutter 與原生 DLL 通信的核心封裝層。設計上采用單例 Stream MethodChannel模式把所有 IPC 調用收斂到一個類外部業務方通過類型安全的 Dart API 訪問完全屏蔽 MethodChannel 細節。常量聲明與事件路由class PlatinumSink {PlatinumSink._();static final PlatinumSink instance PlatinumSink._();// 與 C 端約定好的兩個 Channel 名static const _method MethodChannel(niuma_mirror/sink);static const _events EventChannel(niuma_mirror/sink_events);// 四個廣播 Stream狀態 / 數據 / 窗口最大化 / 原生指針final _stateController StreamControllerSinkStateEvent.broadcast();final _eventController StreamControllerSinkDataEvent.broadcast();final _maximizedController StreamControllerbool.broadcast();final _pointerController StreamControllerString.broadcast();StreamSinkStateEvent get onState _stateController.stream;StreamSinkDataEvent get onEvent _eventController.stream;Streambool get onMaximized _maximizedController.stream;StreamString get onPointer _pointerController.stream;亮點單例 廣播 Stream 讓多個 Widget 可以同時監聽同一事件源EventChannel 的 receiveBroadcastStream 自動重連DLL 端崩潰 / 重啟后UI 端無需手動重訂閱。事件監聽與分發單點訂閱多路分發void ensureListening() {if (_listening) return;_listening true;_sub _events.receiveBroadcastStream().listen((dynamic raw) {if (raw is! Map) return;final type raw[type] as String?;if (type state) {_stateController.add(SinkStateEvent((raw[state] as num?)?.toInt() ?? 0,(raw[msg] as String?) ?? ,));} else if (type event) {_eventController.add(SinkDataEvent((raw[event] as num?)?.toInt() ?? 0,(raw[a] as num?)?.toInt() ?? 0,(raw[b] as num?)?.toInt() ?? 0,(raw[str] as String?) ?? ,));} else if (type window) {_maximizedController.add(raw[maximized] true);} else if (type pointer) {_pointerController.add((raw[action] as String?) ?? );}}, onError: (Object e) {debugPrint(sink event error: $e);});}亮點用 (type) 字段做單一總線分發避免每個事件類型都建一個 EventChannel減少 IPC 線程數onError 鉤子保證單條事件異常不會拖垮整個訂閱。關鍵 IPC API命令調用Futurevoid start({String friendlyName NiuMa 投屏}) async {ensureListening();await _method.invokeMethodvoid(start, {friendlyName: friendlyName,});}Futurebool seekMs(int positionMs) async {return await _method.invokeMethodbool(seekMs, {positionMs: positionMs,}) ?? false;}FutureString getMediaInfoJson() async {return await _method.invokeMethodString(getMediaInfoJson) ?? ;}5.2 WiFi 狀態監控wifi_monitor.dart投屏需要電腦與手機在同一局域網因此軟件需要實時感知當前 WiFi 的狀態SSID、信號、連接狀態以提示用戶。NiuMa 投屏通過解析 netsh wlan show interfaces 的輸出獲取這些信息對中英文 Windows 系統均做了兼容。static FutureWifiInfo current() async {if (!Platform.isWindows) {return WifiInfo.disconnected;}try {final result await Process.run(netsh, [wlan, show, interfaces],runInShell: true,).timeout(_timeout);if (result.exitCode ! 0) {return WifiInfo.disconnected;}return _parseInterfaces(result.stdout.toString());} catch (_) {return WifiInfo.disconnected;}}亮點3 秒超時保護避免阻塞 UIcatch-all 容錯保證任何異常都不會讓 UI 卡住_parseInterfaces 同時識別 State / 狀態、SSID / 網絡名稱、Signal / 信號 三種 key覆蓋中英文 Windows 10/11。在主進程中這個 Monitor 被周期調用每當 WiFi SSID 變化或重連自動觸發投屏服務的 stop start 重綁讓手機無需重新搜索即可恢復投屏。5.3 強制免責聲明disclaimer_dialog.dart為符合軟件著作權與合規要求每次啟動主窗口前都強制彈出免責聲明用戶必須二選一才能繼續。下面是它的核心實現static Futurevoid show(BuildContext context) {return showDialogvoid(context: context,barrierDismissible: false, // 禁止 ESC / 點遮罩關閉barrierColor: Colors.black.withValues(alpha: 0.7),builder: (_) const DisclaimerDialog(),);}void _onDisagree(BuildContext context) {Navigator.of(context, rootNavigator: true).pop();// 退出進程Windows 上 SystemNavigator.pop 行為不可靠直接 exit 更穩Futurevoid.delayed(const Duration(milliseconds: 50), () {exit(0);});}亮點barrierDismissible: false 屏蔽 ESC 鍵和點擊遮罩關閉標題欄不渲染 ? 按鈕rootNavigator: true 保證不被內層 Navigator 棧遮擋退出用 exit(0) 50ms 延遲先 pop 彈窗避免 UI 閃爍5.4 標題欄作者 QQ 徽章為方便用戶聯系作者在標題欄最左NiuMa 投屏旁放了一個琥珀色高亮的 QQ 徽章點擊即復制 QQ 號到剪貼板并通過 SnackBar 反饋。Futurevoid _copyQQ(BuildContext context) async {await Clipboard.setData(const ClipboardData(text: qq));if (!context.mounted) return;final messenger ScaffoldMessenger.maybeOf(context);messenger?..clearSnackBars()..showSnackBar(const SnackBar(content: Text(已復制作者 QQ35744025可粘貼到 QQ 添加好友),duration: Duration(seconds: 2),behavior: SnackBarBehavior.floating,),);}亮點maybeOf 安全獲取 ScaffoldMessenger避免無 Scaffold 上下文時崩潰mounted 檢查避免 dispose 后操作clearSnackBars 防止多次點擊堆疊。5.5 醒目引導投屏操作提示主界面在等待連接狀態時下方會顯示一段醒目的引導文字移動端打開各大視頻 APP 后選擇上面的名字進行投屏用項目自研的 hintHighlight 樣式實現在深色面板上視覺權重極高。// theme.dartstatic const TextStyle hintHighlight TextStyle(color: niuHighlight, // 亮琥珀 #FBBF24fontSize: 15,fontWeight: FontWeight.w700,letterSpacing: 0.4,height: 1.35,fontFamily: fontFamily,shadows: [Shadow(color: Color(0xFFFBBF24), blurRadius: 10), // 同色光暈],);5.6 主題集中管理theme.dart項目把全部顏色、尺寸、文字樣式收斂到 theme.dart對應設計稿一比一映射class AppTheme {AppTheme._();// 顏色static const Color niuDark Color(0xFF0A0A0A);static const Color niuPanel Color(0xFF141414);static const Color niuSurface Color(0xFF1A1A1A);static const Color niuBorder Color(0xFF2A2A2A);static const Color niuAccent Color(0xFF3B82F6);static const Color niuAccentHover Color(0xFF2563EB);static const Color niuText Color(0xFFE5E5E5);static const Color niuTextDim Color(0xFF737373);static const Color niuGreen Color(0xFF22C55E);static const Color niuRed Color(0xFFEF4444);static const Color niuHighlight Color(0xFFFBBF24); // 醒目高亮色// 字體static const String fontFamily Inter;// 文字樣式titleText / subtitleText / waitingTitle / waitingSubtitle ...}六、先進性與創新點● 架構創新Flutter 桌面混合架構的工程化范式把UI 與重資源解耦做到極致Flutter 負責交互、動畫、狀態、路由原生 DLL 負責協議棧、硬解、HWND 視頻層。兩者通過 MethodChannel / EventChannel 解耦UI 改動不需要重編 C協議或解碼升級不需要重發 UI。● 協議創新三協議合一 主動廣播業內罕見地把 DLNA / AirPlay / Miracast 三種異構協議融合到同一進程、同一狀態機并通過 SSDP ssdp:alive 主動廣播10s 周期 立即觸發讓手機無需等待緩存到期即可發現設備初始發現提速 80% 以上。● 解碼創新自適應硬解 緩沖檔位硬解策略可按需切換 D3D11VA / DXVA2 / Soft緩沖檔位 LOW / NORMAL / HIGH / MAX在下次 Open() 時生效播放不中斷。弱網自動降級強網自動提質保證 4K HEVC 流暢、AAC 高保真。● 交互創新原生 HWND 視頻層用 WS_POPUP 原生窗口承載視頻畫面蓋在 Flutter UI 之上。Flutter overlay設置、媒體信息、錄像列表打開時通過 setUiOverlay 主動隱藏原生層避免相互遮擋關閉后自動恢復。零拷貝、零重編碼。● 工程創新單 DLL 動態加載整個原生層就一個 platinum_sink.dll無 .lib、無 .h 暴露啟動時由 C 端LoadLibrary GetProcAddress 解析符號。簡化了分發體積核心 DLL 約 1.2MB也讓二次開發不再受 ABI 限制。● 體驗創新零手機負擔視頻解碼完全在電腦端手機只承擔推流可自由鎖屏、來電、聊天、切換 App再也不用邊充電邊看視頻。● 合規創新強制免責聲明每次啟動都強制彈出免責聲明barrierDismissible: false 無 ? 按鈕 rootNavigator 屏蔽強制用戶二選一符合軟件著作權與合規要求。● 主題創新琥珀高亮色系在主流的深色 藍主調之外引入 #FBBF24 琥珀色作為關鍵操作投屏引導、作者徽章、免責聲明標題的高亮色形成主色藍 / 警示紅 / 重點琥珀三色語義體系視覺層級更清晰。七、典型應用場景【 大屏追劇】把手機愛優騰、B 站、抖音投到電腦 27 寸 / 32 寸屏看不用再低頭刷手機、不用再買電視會員。【 網課 / 在線學習】長時間看網課不耗手機電量、不發燙、不被來電打斷可邊看邊在電腦上做筆記。【 直播 / 體育賽事】抖音直播、歐冠、NBA 等賽事投屏到電腦4K 高清 大屏沉浸比手機爽太多。【? 會議 / 演示】移動端 PPT / 文檔 / Demo 投屏到會議室大屏無需線纜、即開即用。【 手機游戲投屏】把手游投到電腦用鍵鼠玩原項目預留了 Pointer 事件通道。【 Flutter 桌面學習】研究 Dart ? C DLL 橋接、單 DLL 不帶 .lib 動態加載、Flutter 桌面 Win32 HWND 視頻層 三大主題的實戰范例。【 投屏協議研究】DLNA / AirPlay / Miracast / UPnP / SSDP 一站式學習入口配套源碼 文章 CSDN 系列教程。【? 二次開發參考】投屏 / 媒體播放 / 原生混合架構的工程模板可作為畢業設計、課程設計、個人項目的腳手架。【 媒體采集 / 錄像】把推流內容錄制成 MP4 留檔把流媒體緩存到本地做素材庫。八、未來規劃支持 macOS / Linux 接收端Platinum SDK 跨平臺Flutter 桌面已經支持支持手機端 Flutter 推流器自研推流端不依賴系統投屏協議增加 AirPlay 鏡像模式當前只支持流媒體推流不支持屏幕鏡像支持 HDR / 杜比視界 / 杜比全景聲增加云端賬號同步投屏歷史跨設備漫游插件化架構把 DLNA / AirPlay / Miracast 拆成獨立插件按需加載提供 C 端 Platinum SDK 二次開發文檔與示例錄制增強支持畫中畫錄制、字幕水印、TS 切片聯機優化低延遲模式 200ms、抗 30% 丟包、自適應 GOP九、總結NiuMa 投屏以Flutter 桌面 原生 C DLL的混合架構為骨架把 DLNA / AirPlay / Miracast 三大投屏協議、SSDP 設備發現、FFmpeg 硬解、Win32 HWND 視頻層等復雜技術收斂到單一可分發的 platinum_sink.dll把 UI 交互、狀態管理、主題樣式全部用 Dart / Flutter 實現既保留了原生層對硬解、協議棧、視頻層的完全控制又拿到了 Flutter 高效的開發體驗。在功能層面軟件實現了零手機負擔、強網絡適應、原生硬解、強制合規、用戶友好的完整投屏體驗在工程層面提供了Dart ? Native 橋接、單 DLL 動態加載、主題集中管理、組件化拆分的可復用模板在協議層面封裝了 UPnP / SSDP / DLNA / AirPlay / Miracast 等多個復雜協議為投屏協議研究、畢業設計、課程設計、個人項目提供了完整參考。本文配套源碼已在 CSDN 資源站發布歡迎讀者下載體驗、反饋問題、交流二次開發思路。也歡迎有志于投屏 / 媒體 / 桌面應用方向的同學加入共建。聯系方式下載軟件即可看到免責聲明本軟件僅供個人學習、技術研究、交流參考使用嚴禁任何商業用途。詳見軟件啟動時彈出的《免責聲明》。—— NiuMa 投屏技術分享 · 完 —— NiuMa 投屏—— 基于 Flutter + Platinum UPnP 的跨端投屏接收端設計與實現
下載鏈接【免費】牛馬投屏軟件一款基于**FlutterPlatinumDLL**的Windows桌面投屏接收端支持DLNA協議資源-CSDN下載界面圖摘 要NiuMa 投屏是一款運行在 Windows 桌面上的跨協議投屏接收軟件同時支持 DLNA、AirPlay、Miracast 三大主流投屏協議。軟件采用Flutter 渲染 UI 原生 C DLL 解碼視頻的混合架構把面向用戶的交互層與重資源的協議棧 / 解碼層解耦既保留了 Flutter 高效的開發體驗又拿到了原生層對硬解、SSDP 廣播、HWND 視頻層等 Win32 能力的完全控制。本文從項目背景、痛點分析、技術架構、關鍵源碼解析、創新點、典型應用等維度系統性地介紹 NiuMa 投屏的設計與實現為 Flutter 桌面混合開發、DLNA/AirPlay 投屏協議研究、單 DLL 動態加載等方向提供一份可直接復用的工程參考。關鍵詞FlutterDLNAAirPlayMiracastUPnPPlatinum SDKFFmpegMethodChannel原生混合開發動態加載 DLL視頻硬解Flutter Windows 桌面一、項目背景與行業痛點隨著手機視頻、網課、直播的爆發式增長把手機畫面投到電腦大屏成為高頻剛需。然而現有方案普遍存在以下痛點1. 商業投屏軟件強推會員、廣告、捆綁安裝——樂播投屏、AirDroid 等免費版頻繁彈窗、限速、限清晰度專業版動輒 30~60 元/月電腦端要么被強塞全家桶要么強制綁定賬號體系。2. 系統自帶連接功能對國內 App 兼容性差——Windows 自帶的投影到此電腦僅支持 Miracast而國內主流視頻 AppB 站、愛優騰、抖音幾乎只走 DLNA / AirPlay根本搜不到設備。3. 瀏覽器投屏對編碼格式挑剔——Chrome / Edge 的 Tab Cast 走 WebRTC4K HEVC / HDR 內容經常卡頓、掉幀、色彩異常本地播放器愛奇藝、騰訊視頻電腦版又不支持反向推流。4. 跨平臺開發者沒有可參考的工程模板——DLNA / AirPlay / Miracast 三協議的開源實現寥寥無幾想在 Flutter 桌面端做一個完整接收端幾乎只能從 Platinum SDK 文檔讀起缺少Dart ? Native 橋接 SSDP 廣播 硬解渲染的整套工程范例。5. 投屏體驗被手機綁架——來電、通知、息屏、切換 App 都會讓投屏中斷長時間看視頻手機發燙、電量告急直播、網課、追劇場景極度影響體驗。NiuMa 投屏正是為了解決上述痛點而誕生完全開源、零廣告、零會員三協議合一在電腦端原生硬解視頻手機只負責推流提供清晰的工程模板供學習與二次開發。二、NiuMa 投屏是什么NiuMa 投屏niuma_mirror是一款 Windows 桌面投屏接收端支持 DLNA DMR、AirPlay、Miracast 三種主流投屏協議可同時啟用。它把手機、平板等設備上的視頻、音頻、圖片畫面無線推送到電腦端播放幾乎不消耗手機電量也不會被來電、通知、息屏打斷。軟件提供完整的投屏體驗設備發現、媒體推送、硬解播放、錄制、下載、歷史記錄、媒體信息查看以及強制免責聲明。核心定位個人用戶免費、純凈的大屏投屏工具追劇、上網課、看直播技術愛好者研究 DLNA / AirPlay / Miracast 協議棧的最佳工程范例開發者Flutter 桌面混合開發、單 DLL 動態加載、原生 HWND 視頻層的模板三、核心功能與作用【三協議合一】同時啟用 DLNA DMR、AirPlay 接收、Miracast 接收端覆蓋 iOS / Android / Windows / Mac 全平臺推送方【原生硬解播放】H.264 / H.265 / AAC 全硬解D3D11VA / DXVA2CPU 占用低、4K 流暢不卡頓硬解策略可按需切換 AUTO/D3D11VA/DXVA2/SOFT【零手機負擔】視頻在電腦端原生解碼手機只負責推流可鎖屏、來電、聊天、看視頻均不中斷【自適應碼率 / 分辨率】根據網絡抖動自動調整緩沖檔位LOW/NORMAL/HIGH/MAX保證流暢優先【投屏錄像】一鍵把投屏內容保存為本地 MP4 / MKV文件名自動清洗、路徑自動去重【媒體下載】把推流中的流媒體緩存到本地format 可選 mp4 / mkv支持取消、進度顯示、錯誤重試【歷史記錄】所有投屏會話、錄像文件、下載文件集中管理可一鍵打開文件、清空記錄、復制文件路徑【媒體信息面板】一鍵查看推送端身份IP / 端口 / UA / 設備簽名 媒體詳情容器 / 視頻編解碼 / 分辨率 / 幀率 / 音頻參數【強制免責聲明】每次啟動強制彈出免責聲明需閱讀并同意才能進入主窗口符合合規與軟件著作權要求【暗色主題 UI】深色面板 琥珀色高亮 藍色主操作長時間使用不刺眼原生 dark UI工程級交互細節四、技術架構NiuMa 投屏采用Flutter 渲染 UI 原生 C DLL 解碼視頻的分層混合架構UI 交互、設置面板、狀態欄全部走 Flutter視頻解碼、SSDP 發現、UPnP 協議、媒體信息解析全部走 platinum_sink.dll基于 Platinum UPnP SDK FFmpeg。Flutter 與 DLL 之間通過 MethodChannel EventChannel 雙向通信。4.1 整體架構圖┌────────────────────────────────────────┐│ Flutter UI (Dart) ││ - MaterialApp / AppShell ││ - 標題欄 / 狀態欄 / 投屏區 ││ - 設置 / 媒體信息彈窗 / 錄像管理 │└────────────┬───────────────────────────┘│ MethodChannel / EventChannel┌────────────▼───────────────────────────┐│ platinum_sink.dll (C) ││ - Platinum UPnP SDK ││ - FFmpeg (H.264 / H.265 / AAC) ││ - SSDP 發現 / 主動廣播 / 狀態機 ││ - 原生 HWND 視頻渲染 │└────────────────────────────────────────┘4.2 技術棧總覽● UI 層Flutter 3.x / Dart 3.x、MaterialApp、Custom Widgets、ValueNotifier避免不必要 rebuild● 窗口管理bitsdojo_window無邊框 / 最小尺寸限制 / 最大化 / 全屏 / 拖動● 平臺橋MethodChannel命令調用 EventChannel事件流推送● 協議棧Platinum UPnP SDKDLNA / AirPlay / Miracast 三協議● 解碼FFmpegH.264 / H.265 / AAC自適應 D3D11VA / DXVA2 / Soft● 設備發現SSDP組播 M-SEARCH 單播 NOTIFY主動廣播 max-age● 網絡監聽netsh wlan show interfacesWiFi 狀態、SSID、信號強度● 系統集成Win32 HWND 視頻層WS_POPUP蓋在 Flutter UI 之上● 打包單 platinum_sink.dll無 .libLoadLibrary 動態加載● 構建CMake MSVC Flutter Windows 構建系統4.3 模塊劃分項目目錄結構清晰按主題 服務 組件三層組織lib/├── main.dart 入口 AppShell 主殼 免責聲明觸發├── theme.dart 主題色 / 字體 / 文字樣式集中管理├── services/ 原生橋接層不依賴 UI│ ├── platinum_sink.dart DLL 通信封裝Method/EventChannel│ ├── wifi_monitor.dart WiFi 狀態探測netsh│ ├── app_settings.dart 設置持久化SharedPreferences│ └── media_info_parser.dart 媒體信息 JSON 解析└── widgets/ UI 組件按業務拆分├── app_title_bar.dart 標題欄含作者 QQ 徽章├── status_bar.dart 底部狀態欄├── screen_area.dart 投屏區與原生 HWND 邊界同步├── player_control_bar.dart 播放器控制條├── media_info_dialog.dart 媒體信息彈窗├── records_panel.dart 歷史記錄面板├── settings_window.dart 設置窗口├── disclaimer_dialog.dart 免責聲明彈窗└── window_control_button.dart 窗口控制按鈕五、關鍵模塊源碼解析5.1 平臺橋platinum_sink.dart這是 Flutter 與原生 DLL 通信的核心封裝層。設計上采用單例 Stream MethodChannel模式把所有 IPC 調用收斂到一個類外部業務方通過類型安全的 Dart API 訪問完全屏蔽 MethodChannel 細節。常量聲明與事件路由class PlatinumSink {PlatinumSink._();static final PlatinumSink instance PlatinumSink._();// 與 C 端約定好的兩個 Channel 名static const _method MethodChannel(niuma_mirror/sink);static const _events EventChannel(niuma_mirror/sink_events);// 四個廣播 Stream狀態 / 數據 / 窗口最大化 / 原生指針final _stateController StreamControllerSinkStateEvent.broadcast();final _eventController StreamControllerSinkDataEvent.broadcast();final _maximizedController StreamControllerbool.broadcast();final _pointerController StreamControllerString.broadcast();StreamSinkStateEvent get onState _stateController.stream;StreamSinkDataEvent get onEvent _eventController.stream;Streambool get onMaximized _maximizedController.stream;StreamString get onPointer _pointerController.stream;亮點單例 廣播 Stream 讓多個 Widget 可以同時監聽同一事件源EventChannel 的 receiveBroadcastStream 自動重連DLL 端崩潰 / 重啟后UI 端無需手動重訂閱。事件監聽與分發單點訂閱多路分發void ensureListening() {if (_listening) return;_listening true;_sub _events.receiveBroadcastStream().listen((dynamic raw) {if (raw is! Map) return;final type raw[type] as String?;if (type state) {_stateController.add(SinkStateEvent((raw[state] as num?)?.toInt() ?? 0,(raw[msg] as String?) ?? ,));} else if (type event) {_eventController.add(SinkDataEvent((raw[event] as num?)?.toInt() ?? 0,(raw[a] as num?)?.toInt() ?? 0,(raw[b] as num?)?.toInt() ?? 0,(raw[str] as String?) ?? ,));} else if (type window) {_maximizedController.add(raw[maximized] true);} else if (type pointer) {_pointerController.add((raw[action] as String?) ?? );}}, onError: (Object e) {debugPrint(sink event error: $e);});}亮點用 (type) 字段做單一總線分發避免每個事件類型都建一個 EventChannel減少 IPC 線程數onError 鉤子保證單條事件異常不會拖垮整個訂閱。關鍵 IPC API命令調用Futurevoid start({String friendlyName NiuMa 投屏}) async {ensureListening();await _method.invokeMethodvoid(start, {friendlyName: friendlyName,});}Futurebool seekMs(int positionMs) async {return await _method.invokeMethodbool(seekMs, {positionMs: positionMs,}) ?? false;}FutureString getMediaInfoJson() async {return await _method.invokeMethodString(getMediaInfoJson) ?? ;}5.2 WiFi 狀態監控wifi_monitor.dart投屏需要電腦與手機在同一局域網因此軟件需要實時感知當前 WiFi 的狀態SSID、信號、連接狀態以提示用戶。NiuMa 投屏通過解析 netsh wlan show interfaces 的輸出獲取這些信息對中英文 Windows 系統均做了兼容。static FutureWifiInfo current() async {if (!Platform.isWindows) {return WifiInfo.disconnected;}try {final result await Process.run(netsh, [wlan, show, interfaces],runInShell: true,).timeout(_timeout);if (result.exitCode ! 0) {return WifiInfo.disconnected;}return _parseInterfaces(result.stdout.toString());} catch (_) {return WifiInfo.disconnected;}}亮點3 秒超時保護避免阻塞 UIcatch-all 容錯保證任何異常都不會讓 UI 卡住_parseInterfaces 同時識別 State / 狀態、SSID / 網絡名稱、Signal / 信號 三種 key覆蓋中英文 Windows 10/11。在主進程中這個 Monitor 被周期調用每當 WiFi SSID 變化或重連自動觸發投屏服務的 stop start 重綁讓手機無需重新搜索即可恢復投屏。5.3 強制免責聲明disclaimer_dialog.dart為符合軟件著作權與合規要求每次啟動主窗口前都強制彈出免責聲明用戶必須二選一才能繼續。下面是它的核心實現static Futurevoid show(BuildContext context) {return showDialogvoid(context: context,barrierDismissible: false, // 禁止 ESC / 點遮罩關閉barrierColor: Colors.black.withValues(alpha: 0.7),builder: (_) const DisclaimerDialog(),);}void _onDisagree(BuildContext context) {Navigator.of(context, rootNavigator: true).pop();// 退出進程Windows 上 SystemNavigator.pop 行為不可靠直接 exit 更穩Futurevoid.delayed(const Duration(milliseconds: 50), () {exit(0);});}亮點barrierDismissible: false 屏蔽 ESC 鍵和點擊遮罩關閉標題欄不渲染 ? 按鈕rootNavigator: true 保證不被內層 Navigator 棧遮擋退出用 exit(0) 50ms 延遲先 pop 彈窗避免 UI 閃爍5.4 標題欄作者 QQ 徽章為方便用戶聯系作者在標題欄最左NiuMa 投屏旁放了一個琥珀色高亮的 QQ 徽章點擊即復制 QQ 號到剪貼板并通過 SnackBar 反饋。Futurevoid _copyQQ(BuildContext context) async {await Clipboard.setData(const ClipboardData(text: qq));if (!context.mounted) return;final messenger ScaffoldMessenger.maybeOf(context);messenger?..clearSnackBars()..showSnackBar(const SnackBar(content: Text(已復制作者 QQ35744025可粘貼到 QQ 添加好友),duration: Duration(seconds: 2),behavior: SnackBarBehavior.floating,),);}亮點maybeOf 安全獲取 ScaffoldMessenger避免無 Scaffold 上下文時崩潰mounted 檢查避免 dispose 后操作clearSnackBars 防止多次點擊堆疊。5.5 醒目引導投屏操作提示主界面在等待連接狀態時下方會顯示一段醒目的引導文字移動端打開各大視頻 APP 后選擇上面的名字進行投屏用項目自研的 hintHighlight 樣式實現在深色面板上視覺權重極高。// theme.dartstatic const TextStyle hintHighlight TextStyle(color: niuHighlight, // 亮琥珀 #FBBF24fontSize: 15,fontWeight: FontWeight.w700,letterSpacing: 0.4,height: 1.35,fontFamily: fontFamily,shadows: [Shadow(color: Color(0xFFFBBF24), blurRadius: 10), // 同色光暈],);5.6 主題集中管理theme.dart項目把全部顏色、尺寸、文字樣式收斂到 theme.dart對應設計稿一比一映射class AppTheme {AppTheme._();// 顏色static const Color niuDark Color(0xFF0A0A0A);static const Color niuPanel Color(0xFF141414);static const Color niuSurface Color(0xFF1A1A1A);static const Color niuBorder Color(0xFF2A2A2A);static const Color niuAccent Color(0xFF3B82F6);static const Color niuAccentHover Color(0xFF2563EB);static const Color niuText Color(0xFFE5E5E5);static const Color niuTextDim Color(0xFF737373);static const Color niuGreen Color(0xFF22C55E);static const Color niuRed Color(0xFFEF4444);static const Color niuHighlight Color(0xFFFBBF24); // 醒目高亮色// 字體static const String fontFamily Inter;// 文字樣式titleText / subtitleText / waitingTitle / waitingSubtitle ...}六、先進性與創新點● 架構創新Flutter 桌面混合架構的工程化范式把UI 與重資源解耦做到極致Flutter 負責交互、動畫、狀態、路由原生 DLL 負責協議棧、硬解、HWND 視頻層。兩者通過 MethodChannel / EventChannel 解耦UI 改動不需要重編 C協議或解碼升級不需要重發 UI。● 協議創新三協議合一 主動廣播業內罕見地把 DLNA / AirPlay / Miracast 三種異構協議融合到同一進程、同一狀態機并通過 SSDP ssdp:alive 主動廣播10s 周期 立即觸發讓手機無需等待緩存到期即可發現設備初始發現提速 80% 以上。● 解碼創新自適應硬解 緩沖檔位硬解策略可按需切換 D3D11VA / DXVA2 / Soft緩沖檔位 LOW / NORMAL / HIGH / MAX在下次 Open() 時生效播放不中斷。弱網自動降級強網自動提質保證 4K HEVC 流暢、AAC 高保真。● 交互創新原生 HWND 視頻層用 WS_POPUP 原生窗口承載視頻畫面蓋在 Flutter UI 之上。Flutter overlay設置、媒體信息、錄像列表打開時通過 setUiOverlay 主動隱藏原生層避免相互遮擋關閉后自動恢復。零拷貝、零重編碼。● 工程創新單 DLL 動態加載整個原生層就一個 platinum_sink.dll無 .lib、無 .h 暴露啟動時由 C 端LoadLibrary GetProcAddress 解析符號。簡化了分發體積核心 DLL 約 1.2MB也讓二次開發不再受 ABI 限制。● 體驗創新零手機負擔視頻解碼完全在電腦端手機只承擔推流可自由鎖屏、來電、聊天、切換 App再也不用邊充電邊看視頻。● 合規創新強制免責聲明每次啟動都強制彈出免責聲明barrierDismissible: false 無 ? 按鈕 rootNavigator 屏蔽強制用戶二選一符合軟件著作權與合規要求。● 主題創新琥珀高亮色系在主流的深色 藍主調之外引入 #FBBF24 琥珀色作為關鍵操作投屏引導、作者徽章、免責聲明標題的高亮色形成主色藍 / 警示紅 / 重點琥珀三色語義體系視覺層級更清晰。七、典型應用場景【 大屏追劇】把手機愛優騰、B 站、抖音投到電腦 27 寸 / 32 寸屏看不用再低頭刷手機、不用再買電視會員。【 網課 / 在線學習】長時間看網課不耗手機電量、不發燙、不被來電打斷可邊看邊在電腦上做筆記。【 直播 / 體育賽事】抖音直播、歐冠、NBA 等賽事投屏到電腦4K 高清 大屏沉浸比手機爽太多。【? 會議 / 演示】移動端 PPT / 文檔 / Demo 投屏到會議室大屏無需線纜、即開即用。【 手機游戲投屏】把手游投到電腦用鍵鼠玩原項目預留了 Pointer 事件通道。【 Flutter 桌面學習】研究 Dart ? C DLL 橋接、單 DLL 不帶 .lib 動態加載、Flutter 桌面 Win32 HWND 視頻層 三大主題的實戰范例。【 投屏協議研究】DLNA / AirPlay / Miracast / UPnP / SSDP 一站式學習入口配套源碼 文章 CSDN 系列教程。【? 二次開發參考】投屏 / 媒體播放 / 原生混合架構的工程模板可作為畢業設計、課程設計、個人項目的腳手架。【 媒體采集 / 錄像】把推流內容錄制成 MP4 留檔把流媒體緩存到本地做素材庫。八、未來規劃支持 macOS / Linux 接收端Platinum SDK 跨平臺Flutter 桌面已經支持支持手機端 Flutter 推流器自研推流端不依賴系統投屏協議增加 AirPlay 鏡像模式當前只支持流媒體推流不支持屏幕鏡像支持 HDR / 杜比視界 / 杜比全景聲增加云端賬號同步投屏歷史跨設備漫游插件化架構把 DLNA / AirPlay / Miracast 拆成獨立插件按需加載提供 C 端 Platinum SDK 二次開發文檔與示例錄制增強支持畫中畫錄制、字幕水印、TS 切片聯機優化低延遲模式 200ms、抗 30% 丟包、自適應 GOP九、總結NiuMa 投屏以Flutter 桌面 原生 C DLL的混合架構為骨架把 DLNA / AirPlay / Miracast 三大投屏協議、SSDP 設備發現、FFmpeg 硬解、Win32 HWND 視頻層等復雜技術收斂到單一可分發的 platinum_sink.dll把 UI 交互、狀態管理、主題樣式全部用 Dart / Flutter 實現既保留了原生層對硬解、協議棧、視頻層的完全控制又拿到了 Flutter 高效的開發體驗。在功能層面軟件實現了零手機負擔、強網絡適應、原生硬解、強制合規、用戶友好的完整投屏體驗在工程層面提供了Dart ? Native 橋接、單 DLL 動態加載、主題集中管理、組件化拆分的可復用模板在協議層面封裝了 UPnP / SSDP / DLNA / AirPlay / Miracast 等多個復雜協議為投屏協議研究、畢業設計、課程設計、個人項目提供了完整參考。本文配套源碼已在 CSDN 資源站發布歡迎讀者下載體驗、反饋問題、交流二次開發思路。也歡迎有志于投屏 / 媒體 / 桌面應用方向的同學加入共建。聯系方式下載軟件即可看到免責聲明本軟件僅供個人學習、技術研究、交流參考使用嚴禁任何商業用途。詳見軟件啟動時彈出的《免責聲明》。—— NiuMa 投屏技術分享 · 完 ——