無網路模式
有新版本可用，請點「立即更新」。
⚠️ 離線佇列已滿，最舊訊息已丟棄
傳簡訊 撥打
Pich2Pich · 近距未連線 中繼輔助
本機：—
遠距／跨平台連線
我的6碼
------
近距對講

Web／iPhone：同一熱點用 QR 或貼碼（兩輪）。Android 近距更穩請用 APK Wi‑Fi Direct。

無外網：掃 QR 或貼碼，兩輪（邀請→回應）。兩台須同一熱點。

已連線夥伴
最近連線
最後已知位置
音訊輸出

瀏覽器可能無法切聽筒／藍牙；建議戴耳機減回音。

進階語音狀態
語音

按住發話 · 放開收聽（對齊 APK）

聊天

群組
🖼️

地圖高度請拖曳上方綠線調整（對齊 APK）。

50
隊友資訊與樓層校正
我的樓層：—
樓層 F
氣壓／樓層估算
對方：尚無
樓層：—
距離：—
距離與警報

走散超過門檻會通知；可同時鎖定多位隊友（同一警報距離）。

走散警報 100m
距離調整
手動指定距離
顯示距離 50m
GPS 偏移 0m
多機鎖定監看
地圖操作
定位：—
朝向：—
離線街道圖（PMTiles）

有網時下載活動區，斷網後自動用本機圖；比「線上街道」可靠。

路線
路線點：0
活動圍欄（預覽）

完整開關在安全頁；此處可調半徑與中心並於地圖預覽。

走出活動區警報
半徑 500m
未設定中心
在線的人
人數 0
隊友軌跡（30 分鐘）
—

集合點請到設定 → 集合與活動。

SOS 與報平安
報平安
每 15 分鐘
活動圍欄

圓形活動區；離開會通知。地圖頁可預覽橘色圍欄。

開關與半徑與地圖頁同步。

隊伍端對端加密（E2EE）
端到端加密
偏航守護
偏航 60m
未啟用

或於地圖頁「匯入 GPX 並啟用守護」一鍵載入。

急救卡
近用 Wi‑Fi · 遠用網

① 有網遠距：對講頁輸入對方 6 碼或貼配對碼 · ② Android 近距：Wi‑Fi Direct（對講頁／APK）· ③ 含 iPhone：開混用模式 → 熱點+QR · ④ 安全頁：SOS、圍欄、偏航守護

兩台 Android 近距：到 安裝與下載 下載 APK，開 Wi‑Fi 後在 APK 內搜尋附近手機（50–200 m）。

要與 iPhone／Chrome 互通？改選「熱點+QR」或有網時用 6 碼中繼。

便攜路由器（無外網區網）

單台便攜路由／熱點：全員連同一 LAN。若開「客戶端隔離」則無法互連 → 改熱點+QR 或 Wi‑Fi Direct。

場內活動 Wi‑Fi／大區網（家用路由也可測）

請先手動連同一活動／家用 Wi‑Fi。瀏覽器無法讀完整 DHCP；以閘道探測＋QR／6碼中繼為主。完整 UDP 發現請用 Android APK。

尚未探測

雙探測：閘道 OK／FAIL；裝置互通＝QR 或中繼配對成功。隔離 FAIL 時改 Direct。

混用場景速查表（Android + iPhone）

場景 | 做法 | 語音
--- | --- | ---
兩台 Android、無網 | APK Wi‑Fi Direct | 即時 PTT
Android + iPhone、無網 | 熱點+QR 兩輪 | WebRTC 即時
有網、遠距 | 中繼+6碼 | 約 0.7s 片段
多跳延伸 | 開 Mesh 橋接 | 文字優先

APK 即時 Opus 無法與 iPhone WebRTC 直連；純中繼語音是片段式，屬正常設計。

無網路模式

開啟後優先熱點+QR 近距配對，不自動連中繼（與 APK 相同）。

無網優先

混用模式（含 iPhone）

Android APK + iPhone 同隊：開啟後用 WebRTC 即時語音（熱點+QR）。

混用模式
隊伍多跳 Mesh

中繼與近距之間轉傳，延長範圍（對齊 APK）。

TTL 6
Mesh 中繼橋接
自動背景中繼

偵測到中繼房間內有其他隊友時，自動開啟 Mesh 橋接延伸距離。

自動背景中繼
留守台模式

僅看地圖與接收訊息，關閉發話（與 APK 相同）。

留守台（不發話）
集合與活動
連線捷徑

6碼、貼配對碼、掃 QR 請到對講頁操作。

App 版本

檢查中…

iPhone 主畫面若仍是舊版，請點下方「清除快取並更新」。

通訊方案狀態

Direct 約 50–200m 即時語音；中繼延伸遠距聊天／位置；LoRa 僅文字／位置／SOS。

六種策略在 Chrome／APK 的支援與你目前的連線狀態（Chrome 欄會即時更新）。

情境 | Chrome | APK
--- | --- | ---
有網：中繼+6碼 | — | ✅ 完整
無網近距：熱點+QR | — | ✅ WebView 熱點+QR
無網 50m+：Wi‑Fi Direct | ❌ 瀏覽器無 API | ✅ 完整
便攜路由器 | — | ⚠️ 近距用 Direct；跨平台用 WebView QR
隊伍多跳 Mesh | — | ✅ Mesh 橋接（設定）
幾公里：Meshtastic | — | ✅ 經中繼+MQTT 橋接

已連線夥伴
穩定性與維運

安裝與下載

不必商店：網頁 PWA 或 Android APK。APK 近距用 Wi‑Fi Direct；遠距仍用中繼。

Android APK（手機版） 約 69MB · 版本 v120 · 勿裝 Wear 手錶版（約 22MB）
下載：pich2pich.duckdns.org/download/Pich2Pich.apk

⬇️ 下載 Pich2Pich.apk 📦 下載 Pich2Pich-Android.zip（含安裝說明）
📥 完整下載說明頁
APK 安裝與連線步驟

1. 下載 手機版 APK（約 60MB），不要裝 Wear 手錶版（約 22MB）
2. Play Protect → 更多詳情 → 仍要安裝
3. 首次開啟彈出權限時，請全部按 允許（麥克風、定位、附近裝置、通知）；拒絕可能一開就閃退
4. 兩台 Android 都安裝 APK
5. 開 Wi‑Fi（不必連路由器）
6. 對講頁選「Android APK」→ APK 內搜尋附近手機 → 點對方連線
7. 有網遠距：設定房間 `team1`、PIN `2773` → 開啟中繼輔助

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

1. 確認是 v54 手機版（60MB），不是舊版或 Wear 版
2. 完全解除安裝 → 重開機 → 重新下載 APK
3. 安裝後先允許全部權限再使用（設定 → 應用程式 → Pich2Pich → 權限）
4. Android 13+：應用程式 → Pich2Pich → ⋮ → 允許受限設定

通知被鎖／無法開啟？（Samsung 等）

注意：Pich2Pich 是一般 App，通常沒有「⋮ → 允許受限設定」選項（那是無障礙／通知監聽等特殊權限才需要）。

1. Play 商店 → 個人頭像 → Play 安全防護 → 最近掃描 → 還原 Pich2Pich（比自動封鎖工具更常是元兇）
2. 設定 → 應用程式 → Pich2Pich → 若顯示「已停用」→ 按啟用
3. 同一頁 → 通知 → 全部開啟（需 v58 APK 才會正確跳出通知權限）
4. 設定 → 裝置維護 → 電池 → 背景使用限制 → 把 Pich2Pich 移出「休眠／深度休眠 App」
5. 同一頁 → 電池 → 不受限制
6. 長按主畫面圖示 → 應用程式資訊 (i) → 確認未被「暫停未使用的 App」

顯示「應用程式停用」或無法開啟？

1. 完全解除安裝舊版 → 重開機 → 再裝手機版（60MB，v58）
2. Play 安全防護 → 不要停用 Pich2Pich（見上方通知排查第 1 步）
3. 設定 → 應用程式 → Pich2Pich → 啟用
4. 三星：自動封鎖工具已關仍不行 → 檢查 Play 安全防護與「暫停 App 活動」

仍不行可先用上方「Chrome 安裝網頁版」，功能相近且免 APK。

🗺️ 離線地圖下載

有網時下載到本機；無外網時自動切換離線圖。台灣／濟州／釜山等區域可一鍵下載。

個人
隊伍角色
進階
低電量自動省電
靜音時段（22–7僅震動）
起 迄
大字模式
手套模式
行為
自動重連夥伴
螢幕常亮
通知
語音通知
定位
省電（30秒） 標準（10秒） 即時
地圖
線上街道 離線 PMTiles 格線底圖 標記色
任務板
備份
中繼
穿透
固定網址

App 放 Firebase；WebSocket 中繼放 Oracle 免費 VM 等（Firebase 不跑 WS）。

活動匯出

推薦：分享到手機郵件 App，不用應用程式密碼。選 Gmail／Outlook 附加檔案即可寄出。

進階：一鍵 Email（需 Gmail 應用程式密碼）
寄件 Gmail Gmail 應用程式密碼（16 碼） 收件 Email
延伸
未連線
即使有近距也走 LoRa
無近距時 LoRa 備援

LoRa 僅文字／位置／SOS（無即時語音）；無近距時可佇列後送出。iPhone：Safari 無 Web Bluetooth → 用 Android APK BLE 或 MQTT。

未訂閱

### 偏離路線

### 貼上配對代碼

### QR

配對代碼（可複製或掃上方 QR）

### 掃描 QR

對準 QR 碼，自動辨識

建議距離 25～60 cm；太遠點「近距放大」或從相簿選高清照片

### 離線地圖下載精靈

1. 電腦安裝 Python 3 與 `pmtiles` CLI
2. 在專案目錄執行：
   `python3 tools/make_pmtiles.py --bbox 121.4,24.9,121.6,25.1 --zoom 14`
3. 產出 `web/map/region.pmtiles` 後，設定→地圖選「離線 PMTiles」
4. 或用手機選擇本機 .pmtiles 檔案匯入

### Firebase Hosting 部署

1. 安裝 Node.js，專案根目錄執行 `bash tools/deploy-firebase.sh`
2. 首次會引導登入 Google 並建立 Firebase 專案
3. 部署完成後用手機 Chrome 開啟 `https://你的專案.web.app`
4. 可加入主畫面當 PWA，麥克風/定位需 https

### Android APK — 近距離主通道

1. 電腦執行：`bash tools/build-apk.sh` → 安裝 `app-debug.apk`
2. 兩台 Android 以 Wi‑Fi Direct 配對：近距離對講比瀏覽器 WebRTC 更穩
3. 連上 Wi‑Fi Direct 後 APK 會暫停中繼、改走直連；斷開後自動恢復中繼
4. 遠距仍用設定裡的固定 `wss://` 中繼房間與網頁版互通

Chrome PWA 無法使用 Wi‑Fi Direct，戶外近距建議以 APK 為主通道。

### Meshtastic／LoRa

1. Meshtastic 節點/App 啟用 MQTT，記下 broker 位址與 topic
2. 電腦安裝：`pip install paho-mqtt websocket-client`
3. 執行橋接：
   `python3 server/meshtastic-mqtt-bridge.py --mqtt 127.0.0.1 --relay wss://你的伺服器:8000/ws --room team1 --insecure`
4. Android Chrome 可 BLE 收發文字／位置標籤；完整同步仍建議 MQTT
5. iPhone：Safari 無 Web Bluetooth → 用 Android APK LoRa BLE，或 MQTT 進同一中繼房間
6. 僅文字／位置／SOS（無即時語音）；可開「無近距時 LoRa 備援」或「即使有近距也走 LoRa」

### Android Chrome 加入主畫面

1. 請用 Chrome 開 https://pich2pich.web.app（不要用 LINE／FB 內建瀏覽器）
2. 點右上角 ⋮（三個點）
3. 選 加入主畫面 或 安裝應用程式
4. 按 安裝／新增
5. 之後從主畫面 Pich2Pich 圖示開啟（離線才能用）

若選單裡沒有「加入主畫面」：在此頁多停留 30 秒再試，或更新 Chrome 到最新版。

### 無網路 + 熱點 配對教學

1. 事前（有網時）：兩台 Chrome 開 App → 加入主畫面，之後離線才能開
2. A 開熱點（可關閉分享行動數據），B 連上 A 的 Wi‑Fi
3. 兩台都從主畫面圖示開 Pich2Pich（不是 Chrome 分頁）
4. 接熱點的那台：頂部顯示「區網·待配對」或「無外網模式」是正常的，代表走區網 P2P，不是壞掉
5. 第一輪：A「產生邀請 QR」→ B 可掃 QR或貼碼；畫面會顯示 QR 與可複製的短代碼
6. 第二輪（必做）：B 出現回應 QR/代碼 → A 掃 QR 或貼碼
7. 顯示「已連線夥伴」→ 兩台都按「啟用喇叭」→ 按住說話

仍連不上？ ① 不要用 6 碼（需中繼） ② 關閉熱點「AP 隔離／客戶端隔離」或換另一台當熱點 ③ 兩台都關飛航以外的行動數據，避免走 4G

### iPhone／iPad 安裝（PWA）

1. 請用 Safari 開啟 https://pich2pich.web.app（不要用 LINE／FB 內建瀏覽器）
2. 點下方 分享 按鈕（方框向上箭頭）
3. 選 加入主畫面 → 按 新增
4. 之後從主畫面 Pich2Pich 圖示開啟（離線才能用）
5. 首次使用請允許麥克風與定位（Safari 會詢問）
6. 設定 → 固定中繼填 `wss://pich2pich.duckdns.org`、房間 `team1`、PIN `2773`
7. 無網近距：對講頁選「熱點+QR」兩輪配對（iPhone 無 Wi‑Fi Direct，不能用 Android APK 模式）

iOS 16.4+ 主畫面 App 才支援推播；對講與聊天不需推播也能用。QR 掃描若無法用，改「代碼互貼」。

### 急救卡 QR

救援人員掃描可見血型／過敏（非 E2EE 密鑰）。

隊伍 E2EE QR

掃描後自動匯入房間與密鑰（p2p-e2ee:房間:密鑰）

### ⓪ 出發前離線準備

有網時請完成：下載離線地圖、匯入 GPX 路線、E2EE 密鑰 QR。iPhone 請「加入主畫面」。

多人隊伍：領隊按「隊伍 QR」，新成員掃一次加入。

### ① 連線方式

純 Android：Wi‑Fi Direct。含 iPhone：混用 WebRTC（熱點+QR）。3 人以上：隊伍 QR。

### ② 離線掃 QR

沒網路時：一人「產生邀請 QR」，另一人「掃別人 QR」完成配對；或掃「隊伍 QR」。

### ③ 按住說話

對講機頁先點「啟用喇叭」，再按住大按鈕說話（WebRTC 即時）。放開即停。

### 連線品質儀表板

SOS