# AirAccept 語言:[English](README.md) | [繁體中文](README.zh-TW.md) AirAccept 是一個輕量 macOS 選單列 app,會監看 AirPlay 接收器的連線提示,並且只在提示明確符合 AirPlay 請求時,自動按下 `Accept`。 這個工具適合已經在「系統設定」中啟用內建 AirPlay Receiver 的 Mac。 ## 為什麼需要這個工具 macOS 可以把 Mac 當成 AirPlay Receiver 使用,而且系統設定中可以選擇允許誰 AirPlay 到這台 Mac: - Current User - Anyone on the Same Network - Everyone 但實際使用時,即使 AirPlay Receiver 已經開啟,且 `Allow AirPlay for` 設為 `Anyone on the Same Network` 或 `Everyone`,macOS 仍然可能跳出 AirPlay 連線提示,要求你手動按下 `Accept` 之後才會開始播放。 AirAccept 就是為了解決這個情境:如果你把 Mac 當成常駐 AirPlay 接收器、媒體播放機,或是沒有固定螢幕/鍵盤滑鼠的遠端主機,每次都要手動按 `Accept` 會很不方便。 ## 需求 - macOS Sequoia 15 或 Tahoe 26 - Xcode Command Line Tools 或 Xcode - 需要授予 AirAccept Accessibility 權限 AirAccept 不需要 Screen Recording 權限,也不使用 AppleScript/System Events 自動化。 已測試版本: - macOS Tahoe 26.4.1 - macOS Sequoia 15.7.7 AirAccept 使用 macOS Accessibility API 來檢查 Notification Center。只要 Apple 保持 AirPlay 提示的 Accessibility 結構大致相同,應該可以繼續運作;但這不代表保證支援所有 macOS 版本。 ## 建置 ```sh make test make app ``` app bundle 會產生在: ```text build/AirAccept.app ``` 如果要建置後直接啟動: ```sh make run ``` 如果 `open` 看起來沒有反應,可以用 foreground 模式執行,方便看啟動錯誤: ```sh make debug-run ``` 正常執行時,`debug-run` 會保持執行狀態,直到你退出 AirAccept 或按下 `Ctrl-C`。 建置完成後可以把 app bundle 移到 `/Applications`。建議放在固定路徑,因為 macOS 的 Accessibility 權限會和 app identity/path 有關。 ## 第一次使用 1. 啟動 `build/AirAccept.app`。 2. 從選單列點選 `AirAccept` -> `Request Accessibility Permission`。 3. 到 System Settings -> Privacy & Security -> Accessibility 允許 AirAccept。 4. 選用:如果希望登入時自動啟動,開啟 `AirAccept` -> `Launch at Login`。 5. 如果 macOS 沒有立刻套用權限,請退出並重新開啟 AirAccept。 確認 app 是否有啟動,可以查看 log: ```sh tail -n 20 "$HOME/Library/Logs/AirAccept/airaccept.log" ``` 你應該會看到類似這樣的內容: ```text [info] ... AirAccept launched pid=12345 ``` ## 設定 AirAccept 第一次執行時會建立這個設定檔: ```text ~/Library/Application Support/AirAccept/config.json ``` 預設設定: ```json { "poll_interval_ms": 2500 } ``` `poll_interval_ms` 控制 AirAccept 檢查 Notification Center 中 AirPlay 請求的頻率。 你也可以直接從選單列設定: ```text AirAccept -> Poll Interval -> 2/3/4/5 seconds ``` ## Logs AirAccept 會把 newline-delimited JSON event 寫到: ```text ~/Library/Logs/AirAccept/airaccept.log ``` 每個 event 會包含 timestamp、host process、prompt summary、解析出的 device name、action 和 reason。它也會使用 subsystem `com.airaccept.AirAccept` 寫入 Apple unified logging。 log 檔約 1 MB 時會輪替,並保留前一份檔案在 `airaccept.log.1`。 ## 登入時啟動 使用選單列項目: ```text AirAccept -> Launch at Login ``` 這個功能使用 macOS 13+ 的 `SMAppService.mainApp` login item API。 ## 安全性說明 AirAccept 不會點擊任意系統對話框。提示內容必須包含 AirPlay-specific request text,例如某個裝置想要 AirPlay 到這台 Mac,並且存在 accept-like Accessibility action,AirAccept 才會透過 Accessibility 路徑按下接受。