# 📥 手機要下載的資料

其實不用下載也能用！
手機直接開 https://pich2pich.web.app → 加入主畫面即可。下面檔案是給「Android 原生 APK」或「離線存檔」用的。

## 📋 混用場景速查表

近用 Wi‑Fi · 遠用網 — 依你的裝置組合選對模式，語音品質差很多。

場景 | 推薦做法 | 語音
--- | --- | ---
兩台 Android、無網、50–200 m | 裝 APK → Wi‑Fi Direct 搜尋連線 | 最佳（即時 PTT）
Android + iPhone、無網 | 開熱點 → 選「熱點+QR」兩輪配對（APK 可用 WebView 按鈕） | WebRTC 即時
任意組合、有網、遠距 | 連中繼 + 輸入對方 6 碼（房間 team1） | 約 0.7s 片段（可互通）
需要多跳延伸 | 設定開啟 Mesh 橋接（預設關） | 文字／位置優先

限制：APK 即時 Opus PTT 無法與 iPhone WebRTC 直接互通；iPhone 無 Wi‑Fi Direct。純中繼模式下語音是片段式，非對講機等級延遲，屬正常設計。

## 🍎 iPhone／iPad（Safari 網頁版）

沒有 App Store 版，請用 Safari 安裝 PWA（與 App 內「設定→安裝與下載」說明相同）：

1. Safari 開 https://pich2pich.web.app
2. 分享 → 加入主畫面 → 新增
3. 從主畫面圖示開啟（離線才能用）
4. 首次請允許麥克風、定位
5. 設定中繼 `wss://pich2pich.duckdns.org`、房間 `team1`、PIN `2773`
6. 無網近距：對講頁「熱點+QR」兩輪配對（iPhone 無 Wi‑Fi Direct）

▶ 用 Safari 開啟 Pich2Pich

QR 掃描在 iOS 上若無法用，改「代碼互貼」。

## 📲 Android Chrome（網頁版，免 APK）

Chrome 開網址 → ⋮ → 加入主畫面／安裝應用程式。功能與 APK 相近，近距離建議仍裝 APK。

▶ 用 Chrome 開啟 Pich2Pich 下載 Pich2Pich-Chrome.zip（離線包）

zip 解壓後可 Termux 跑伺服器；一般使用者直接用上方網址即可。

## 🤖 Android 原生 APK（Wi‑Fi Direct 近距）

僅 Android 可安裝。近距對講最穩（50–200 m，不用熱點）。

請下載手機版（約 69MB）。不要裝 Wear 手錶版（約 22MB）。目前版本 v123（Release 簽章，較不易被安全防護停用）。

⬇️ 直接下載 Pich2Pich.apk 📦 下載 Pich2Pich-Android.zip（含安裝說明）

安裝步驟：

1. Play Protect → 更多詳情 → 仍要安裝
2. 首次開啟請允許：麥克風、定位、附近裝置、通知（全部允許，否則可能閃退）
3. 兩台都裝 APK → 開 Wi‑Fi → App 內搜尋附近手機連線
4. 有網遠距：房間 `team1`、PIN `2773` → 開中繼

APK 由 DuckDNS 伺服器提供（Firebase 免費方案無法放 APK）。zip 由 web.app 提供。

## ⚠️ 一開就閃退（應用程式錯誤）？

通常是舊版 APK或權限未允許（v54 已修正啟動順序）：

1. 確認下載的是 手機版 約 69MB（不是 22MB Wear 版）
2. 完全解除安裝舊版 → 重開機 → 重新下載 v120
3. 安裝後先允許全部權限：設定 → 應用程式 → Pich2Pich → 權限
4. 若 App 被停用：Play 安全防護 → 還原（見下方通知排查）

## 🔔 通知被鎖／Samsung A23 等

沒有「允許受限設定」是正常的。那個選項只給無障礙、通知監聽等特殊 App；Pich2Pich 不需要，找不到不代表你漏做。

三星 A23 請改做：

1. Play 商店 → 頭像 → Play 安全防護 → 最近掃描 → 還原 Pich2Pich（最常見原因）
2. 設定 → 應用程式 → Pich2Pich → 若「已停用」→ 按啟用
3. 同一頁 → 通知 → 全部開啟（請用 v58 APK）
4. 設定 → 裝置維護 → 電池 → 背景使用限制 → 移出「休眠 App」
5. Pich2Pich → 電池 → 不受限制

自動封鎖工具關閉仍被鎖 → 幾乎都是 Play 安全防護，不是自動封鎖工具。

## ⚠️ 顯示「應用程式停用」？

這是 Android／Play 安全防護 把側載 App 關掉，不是病毒：

1. 完全解除安裝 → 重開機 → 重新下載 APK
2. Play Protect → 更多詳情 → 仍要安裝
3. 設定 → 應用程式 → Pich2Pich → 啟用
4. Play 安全防護 → 最近掃描 → 不要停用 Pich2Pich
5. 三星：設定 → 安全性 → 自動封鎖工具 → 允許 Chrome 安裝

仍不行請先用上方 Chrome／Safari 網頁版（加入主畫面）。

## 🗺️ 離線地圖（PMTiles）

有網時下載到 App 本機，無外網時仍可看街道／地形圖。

建議：開 App → 設定 → 安裝與下載 → 離線地圖下載，一鍵存入本機。

載入區域列表…
▶ 開 App 下載到本機（推薦）

## 各情況要下載什麼？

- iPhone／iPad → 不用下載檔案，Safari 加入主畫面
- Android 有網 → Chrome 加入主畫面，或裝 APK 近距更遠
- 無網、Chrome／iPhone → 熱點 + QR 兩輪
- 無網、兩台 Android → APK + Wi‑Fi Direct 搜尋連線
- 無外網也要地圖 → App 內離線地圖下載