智慧電視遙控器

一、系統需求

• 電視：Android TV / Google TV（Android 9 以上），內建 Android TV Remote Service
• 手機：iPhone 或 iPad（iOS 15 以上）
• 網路：手機與電視必須連在同一個 Wi-Fi（硬性條件）
• 安裝方式：透過 Xcode 以個人 Apple ID 簽章安裝（不上架 App Store）

二、安裝與首次設定

1. 用 USB 將 iPhone 接上 Mac，在 Xcode 中選擇你的裝置並按 ▶ 執行
2. iPhone 需開啟開發者模式：設定 → 隱私權與安全性 → 開發者模式
3. 首次安裝後到設定 → 一般 → VPN 與裝置管理，信任你的開發者憑證
4. 開啟 App 時，請允許區域網路權限（搜尋電視必要）

三、連線與配對

自動搜尋

1. 確認電視已開機、與手機在同一 Wi-Fi
2. 開啟 App，在「附近的電視」清單點選你的電視
3. 電視螢幕會顯示 6 碼十六進位配對碼（如 A1B2C3）
4. 在 App 輸入 6 碼 → 按「確認配對」
5. 配對成功後進入遙控器主畫面；之後同一台電視可免 PIN 直接連線

手動輸入 IP

若搜尋不到電視，點「手動輸入 IP 連線」，輸入電視 IP（可在電視「設定 → 網路」查看）。

四、遙控器功能說明

頂部功能列（四鍵）

底部固定區

首頁的 更新 App 列可開啟 SideStore 安裝連結；書本 圖示開啟本說明書。右上角 ✕ 可中斷連線。

五、四種輸入模式

方向鍵

大型方向鍵 + 中央藍色 OK 鍵，適合一般選單操作。

觸控板

在面板滑動對應上下左右方向鍵，輕點對應 OK。Android TV 沒有自由游標，無法像滑鼠一樣移動指標。

鍵盤

輸入英數文字後按「輸入到電視」，文字會逐字送入電視搜尋框。支援麥克風語音轉文字（實驗性，英文效果較佳）。

App

一鍵啟動電視上已安裝的 App：

• YouTube、Netflix、Disney+、Prime Video
• Spotify、Apple TV、Plex

六、已知限制

• 僅支援 Android TV / Google TV，不支援 Samsung、LG 等其他品牌
• 手機與電視必須在同一 Wi-Fi，不支援跨網段或行動數據
• 觸控板無自由游標，僅能轉成方向鍵
• 鍵盤 / 語音輸入僅支援英數字元
• 語音為裝置端辨識後送文字，非電視原生語音助理
• 免費簽章 App 每 7 天需重簽（見下方）

七、7 天重簽說明

使用免費 Apple ID 安裝的自製 App，簽章有效期為 7 天。到期後 App 圖示仍在，但點開會顯示「無法驗證」。

解法：完成 SideStore 一次性設定後，讓 SideStore 自動重簽；或將 iPhone 接上 Mac，在 Xcode 再按一次 ▶ 重新安裝。

可選方案：

• SideStore（推薦）：完成一次性安裝設定後，手機會在背景自動執行重簽。 首次設定需用 Mac 產生配對檔並側載 SideStore；之後由 SideStore 管理本 App 的簽章更新。
• AltStore：需同一 Wi-Fi 下有一台電腦開著 AltServer，由電腦自動背景重簽。
• 付費開發者帳號（$99/年）：簽章有效期一年，或透過 TestFlight 分享給他人。

八、雲端更新（SideStore）

完成一次性 SideStore 設定後，可用 Cloudflare R2 公開下載的 .ipa 安裝與更新 App，不必每週接 Mac。

下載連結

建議先用 Safari 開啟 SideStore 一鍵安裝連結；版本更新時 IPA 固定網址不變。

A. 一次性設定 SideStore（Mac + iPhone，只需做一次）

1. iPhone 開啟開發者模式：設定 → 隱私權與安全性 → 開發者模式，重開機後確認開啟。
2. iPhone 從 App Store 安裝 LocalDevVPN。若系統要求加入 VPN 設定，請允許並輸入手機密碼。
3. 到 SideStore 官網 下載 SideStore 與安裝工具。
4. 用 USB 將 iPhone 接上 Mac，依 SideStore 官方流程產生 pairing file（配對檔）。
5. 用 SideStore 官方安裝工具或 AltServer 將 SideStore 側載到 iPhone。
6. iPhone 到 設定 → 一般 → VPN 與裝置管理，信任你的 Apple ID 開發者憑證。
7. 開啟 SideStore，匯入剛產生的 pairing file，並登入用來簽章的 Apple ID。
8. 開啟 LocalDevVPN 並按 Connect。回到 SideStore → Settings → VPN Configuration，確認 Active 顯示 Yes。

B. 首次用 SideStore 安裝本 App

1. 先確認 LocalDevVPN 已連線，且 SideStore → Settings → VPN Configuration 顯示 Active Yes。
2. 在 Safari 開啟上方 用 SideStore 安裝 / 更新 連結。
3. 若 iPhone 詢問是否開啟 SideStore，請選擇允許，等待 SideStore 下載、簽章並安裝。
4. 若 SideStore 的 ＋ 只出現檔案資料夾，表示它正在選本機 IPA；可改用 Safari 直接下載 IPA，再回 SideStore 按 ＋ 從 Files 選下載的 IPA。
5. 安裝完成後開啟 App，允許區域網路權限，才能搜尋電視。
6. 安裝完成後，SideStore 會在背景自動重簽（解決 7 天過期）

C. 功能有更新時（不用接 Mac）

1. 開發者更新 version.json 並觸發雲端建置，產生新版 IPA。
2. 開發者執行 ./scripts/upload-ipa-r2.sh，將新版 IPA 同步到 R2 固定連結。
3. 手機確認 LocalDevVPN 已連線，且 SideStore → Settings → VPN Configuration 顯示 Active Yes。
4. 手機用 Safari 開啟上方 SideStore 一鍵安裝連結，或在 App 內點 更新 App 列。
5. 備案：複製 IPA 固定下載 URL，用 Safari 下載 IPA，再到 SideStore 按 ＋ 從 Files 選取下載的 IPA。

D. 自動測試前準備

1. iPhone 接上 Mac 並保持解鎖。
2. LocalDevVPN 已安裝並連線。
3. SideStore 已登入 Apple ID，且已匯入 pairing file。
4. SideStore → My Apps 可以看到「電視遙控器」，並顯示 7 天有效期或可 Refresh。
5. 若需要 Codex 自動檢查，可執行 ./scripts/check-sidestore-prereqs.sh --device DEVICE_ID。

E. Siri 開啟電視

1. 請在 SideStore 版 App 裡設定電視 MAC 位址，並確認電視已開啟網路喚醒或快速啟動。
2. 建議說完整指令：「電視遙控器 開啟電視」、「電視遙控器 打開電視」或「電視遙控器 電視開機」。
3. Siri 執行時可能會同時打開 App，這是正常現象；重點是它會一併重送喚醒封包。
4. 不要只說「開啟電視」；iPhone 可能會把它理解成單純打開 App，而不是執行喚醒捷徑。
5. 若 App 內手動按「喚醒」可以開機，但 Siri 不行，請重新到「一鍵設定 5 個 Siri 指令」同步捷徑後再試。

F. 常見問題

九、版本更新紀錄