一、系統需求
- 電視：Android TV / Google TV（Android 9 以上），內建 Android TV Remote Service
- 手機：iPhone 或 iPad（iOS 15 以上）
- 網路：手機與電視必須連在同一個 Wi-Fi（硬性條件）
- 安裝方式：透過 Xcode 以個人 Apple ID 簽章安裝（不上架 App Store）
二、安裝與首次設定
- 用 USB 將 iPhone 接上 Mac，在 Xcode 中選擇你的裝置並按 ▶ 執行
- iPhone 需開啟開發者模式：設定 → 隱私權與安全性 → 開發者模式
- 首次安裝後到設定 → 一般 → VPN 與裝置管理，信任你的開發者憑證
- 開啟 App 時，請允許區域網路權限（搜尋電視必要）
免費 Apple ID 簽章的 App 每 7 天需重新安裝一次，詳見下方「7 天重簽說明」。
SideStore 安裝設定完成後，可於背景自動執行重簽，不必每週手動接 Mac。
三、連線與配對
自動搜尋
- 確認電視已開機、與手機在同一 Wi-Fi
- 開啟 App，在「附近的電視」清單點選你的電視
- 電視螢幕會顯示 6 碼十六進位配對碼（如 A1B2C3）
- 在 App 輸入 6 碼 → 按「確認配對」
- 配對成功後進入遙控器主畫面；之後同一台電視可免 PIN 直接連線
手動輸入 IP
若搜尋不到電視，點「手動輸入 IP 連線」，輸入電視 IP（可在電視「設定 → 網路」查看）。
四、遙控器功能說明
頂部功能列（四鍵）
電源開關電視
訊號源開啟輸入來源選單（HDMI 切換等）
主頁回到電視主畫面
返回上一頁 / 返回
底部固定區
| 按鈕 | 功能 |
|---|
| ◀◀ / ▶▶ | 倒轉 / 快轉 |
| ▶❚❚ | 播放 / 暫停 |
| 音量加 / 減 / 靜音 | 音量控制 |
左上角 ↓ 可開啟公開 IPA 下載連結（SideStore 更新用）；書本 圖示開啟本說明書。右上角 ✕ 可中斷連線。
五、四種輸入模式
方向鍵
大型方向鍵 + 中央藍色 OK 鍵，適合一般選單操作。
觸控板
在面板滑動對應上下左右方向鍵，輕點對應 OK。Android TV 沒有自由游標，無法像滑鼠一樣移動指標。
鍵盤
輸入英數文字後按「輸入到電視」，文字會逐字送入電視搜尋框。支援麥克風語音轉文字（實驗性，英文效果較佳）。
鍵盤模式僅支援英數與少數符號，中文無法以此方式送入電視。
App
一鍵啟動電視上已安裝的 App：
- YouTube、Netflix、Disney+、Prime Video
- Spotify、Apple TV、Plex
僅能啟動電視上已安裝的 App；若未安裝則無反應。
六、已知限制
- 僅支援 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 解決的是「7 天簽章過期」問題；若 App 功能有更新（程式碼變更），
仍需將新版 .ipa 透過 SideStore 重新安裝一次。
八、雲端更新（SideStore）
完成一次性 SideStore 設定後，可用 Cloudflare R2 公開下載的 .ipa 安裝與更新 App，不必每週接 Mac。
下載連結
SideStore 從 URL 安裝時，請貼上這個固定連結；版本更新時網址不變：
載入中…
A. 一次性設定 SideStore（Mac + iPhone，只需做一次）
- iPhone 開啟開發者模式：設定 → 隱私權與安全性 → 開發者模式，重開機後確認開啟。
- 到 SideStore 官網 下載 SideStore 與安裝工具。
- 用 USB 將 iPhone 接上 Mac，依 SideStore 官方流程產生 pairing file（配對檔）。
- 用 SideStore 官方安裝工具或 AltServer 將 SideStore 側載到 iPhone。
- iPhone 到 設定 → 一般 → VPN 與裝置管理，信任你的 Apple ID 開發者憑證。
- 開啟 SideStore，匯入剛產生的 pairing file，並登入用來簽章的 Apple ID。
- SideStore 要求啟用 VPN 時請允許；這是 SideStore 自動重簽需要的本機隧道。
pairing file 與 Apple ID 是個人簽章資料，請不要公開傳給不信任的人。SideStore 官方流程若更新，請以官網最新說明為準。
B. 首次用 SideStore 安裝本 App
- 開啟 SideStore → 我的 App → ＋ → 從 URL 安裝
- 貼上上方 R2 下載連結。
- 等待 SideStore 下載、簽章並安裝
SmartTVRemote.ipa。
- 安裝完成後開啟 App，允許區域網路權限，才能搜尋電視。
- 安裝完成後，SideStore 會在背景自動重簽（解決 7 天過期）
C. 功能有更新時（不用接 Mac）
- 開發者更新
version.json 並觸發雲端建置，產生新版 IPA。
- 開發者執行
./scripts/upload-ipa-r2.sh，將新版 IPA 同步到 R2 固定連結。
- 手機開啟 SideStore → 我的 App → ＋ → 從 URL 安裝，貼上同一個 R2 連結重新安裝。
- App 內左上角 ↓ 也會開啟同一個公開 IPA 下載連結，方便複製或確認最新版。
D. 常見問題
| 狀況 | 處理方式 |
|---|
| SideStore 無法安裝 URL | 確認 iPhone 有網路、SideStore VPN 已開啟，並重新貼上完整 R2 URL。 |
| App 顯示無法驗證 | 開啟 SideStore，對 App 執行 Refresh；若超過 7 天未重簽，重新用同一 URL 安裝。 |
| 搜尋不到電視 | 確認手機與 Android TV / Google TV 在同一 Wi-Fi，並允許 App 的區域網路權限。 |
| 別人無法從 GitHub 下載 | 改用上方 R2 公開 URL；私人 GitHub repo 不影響 R2 下載。 |
SideStore 解決簽章與安裝問題，不會改變 App 功能限制。遙控器仍需手機與電視在同一 Wi-Fi。