REACH / 支援

從遇到的問題開始解決。

連線、螢幕和輸入。 先找到您的症狀,然後分享有助於我們調查的詳細資訊。

本頁內容

從這裡開始

Mac 未出現在清單中

檢查Host是否正在執行,兩個裝置共享一個網路,並且允許訪問本地網路。 VPN和來賓網路隔離可能會阻止發現。

它只是遠端失敗

檢查Reach登入和所選路線。 對於Cloudflare,請將Test Relay path與實際的Viewer連線分開檢查。

螢幕和佈局

兩個×控制元件是做什麼的?

影片上的「×」只中斷該路串流,保留對應的畫面區域。空白區域上的「×」會移除該區域,並重新排列剩餘工作空間。已儲存的預設集不會自動改寫。

「Fit to tile(配合目前區域)」顯示了不同的解析度。

Mac 工作空間的邏輯大小、HiDPI 繪製像素和傳輸影片的尺寸並不相同。請比較要求的設定與實際套用狀態。若配合大小失敗或不受支援,變更並未生效。可選擇「Keep Mac original(維持 Mac 原始大小)」或分享支援報告。

顯示屏或程式塢已移動。

請檢查「讓 Mac 顯示器配置與 iPad 相符」選項,以及 macOS 中的顯示器排列。如果結束工作空間後排列仍未還原,請在重設系統設定前,記錄 Host 與 Viewer 版本,以及變更前後的顯示器排列。

Cloudflare和網路

使用量為零或無法載入。

核對期間、帳戶及 TURN 金鑰範圍,再選擇「Refresh usage」(更新用量)。若出現 401/403,請檢查 Account Analytics: Read 權限、權杖有效期、Account ID 與 IP 篩選條件。顯示零只表示所選範圍內的結果,既不是連線測試,也不是免費額度餘額。

熱點工作正常,但我的公司網路不行。

網路可能限制 UDP、TLS 或 TURN 本身。Host 支援透過 TLS 443 連線的替代路徑,但 Viewer 仍需要 UDP。請根據實際選取的路徑與錯誤代碼確認允許的存取方式,不要因此停用組織的保護措施。

Cloudflare權杖和連線幫助→

詳細的故障排除

Reach Viewer在本地網路上看不到我的Mac。

Nearby 使用 Bonjour 探索裝置,因此 Mac 必須在允許服務通告的網路上持續發出有效通告。請依序檢查:(1) 兩部裝置連上同一個 Wi-Fi,且訪客或公司網路未封鎖 Bonjour/mDNS;(2) Reach Host 正在執行,選單列圖示可見;(3) Mac 與 iPhone/iPad 均已允許區域網路(Local Network)存取,這是裝置探索所需的權限。macOS 通常只詢問一次;若曾拒絕,請在 System Settings → Privacy & Security → Local Network 重新開啟。Mac 上的螢幕錄製和輔助使用權限用於連線後的畫面與控制,不用於尋找 Mac。

只有 Mac 目前透過 Bonjour 發出有效的服務通告,Reach 才認為它可透過 Nearby 連線。先前儲存的 Mac 仍會以最後看見的名稱顯示,但只有名稱不代表可以連線;必須再次收到服務通告,Nearby 才會嘗試連線。若要從其他網路存取該 Mac,請使用已儲存的 Direct IP 位址,或登入後使用 Internet Direct 或 Relay。

在家連線有效,但從外部無法連線。

請選擇符合目前情況的連線路徑。未登入時,下列方式中只有第一種可用。

  • Manual Direct IP(手動輸入 IP)不需要帳戶。目前它需要可連線的公用 IPv4 位址。如果 Mac 本身已有公用 IPv4,就不需要轉送連接埠,直接輸入位址與連接埠即可。如果 Mac 位於路由器或 NAT 後方,請轉送或對應 Reach Host → Connection settings → Direct over Internet 顯示的 UDP 連接埠(預設 8443),再於 Reach Viewer 輸入外部位址和連接埠。CGNAT 無法建立這種對應。若此方式不可用,請登入後使用可選擇公用 IPv6 候選位址的 Internet Direct,或使用 Relay。
  • Internet Direct(網際網路直連)需要 Reach Account。請在 Mac 與 iPhone/iPad 上登入,將 Mac 註冊到帳戶。Reach 便會透過已儲存的連線設定,嘗試直接網際網路路徑的候選位址,包括 NAT 穿透找到的端點、公用 IPv6 位址及路由器對應的端點。同一 Reach Account 下互相信任的裝置不必再次輸入配對碼,但仍需可連通的直接路徑,網路也可能需要額外設定。
  • Relay(中繼連線)需要 Reach Account以及您自己的 Cloudflare TURN 憑證。請依照Cloudflare 設定指南選擇所需權限,並在 Reach Host → Cloudflare relay → Manage… 儲存憑證。嚴格 NAT、對稱 NAT 或 CGNAT 使直接路徑失敗時,可改用 Relay;但仍需要有效的 TURN 憑證與可連線的 TURN 服務,而且延遲會高於直接路徑。

Auto 只會嘗試目前登入狀態允許的路徑,因此未登入時不會暗中嘗試 Internet Direct 或 Relay。您也可以明確選擇路徑;Reach 會為每台 Mac 記住這項選擇。

什麼是 Reach Account?沒有帳戶還能使用哪些功能?

Reach Account 是選用的。登入使用一次性電子郵件連結或驗證碼,不使用密碼。未登入時仍可使用 Nearby/LAN 與手動 Direct IP,並擁有完整的影片、音訊及輸入工作階段;工作階段本身不會降級。登入後可使用 Internet Direct 與 Relay,同一帳戶的裝置也可不輸入配對碼就互相信任。但信任不等於可連線:仍需要可連通的直接連線候選位址,或已設定的中繼連線。

帳戶資料包含電子郵件、裝置識別碼、信任資訊,以及用於登入與裝置存取的連線資訊。驗證安全資料、選用的購買使用權和運作日誌各有不同的保存期限與規則。現行的資料類別與刪除範圍請參閱隱私權政策。

我如何刪除我的帳戶,或者只刪除一臺裝置?

請使用 Viewer 或 Host 的帳戶頁面。Sign out只會結束該裝置的登入;Remove device and sign out會撤銷該裝置的帳戶註冊。Delete account會刪除相關的帳戶資料庫記錄。營運日誌、防濫用狀態、本地設定和 Keychain 認證資訊各有獨立的處理範圍。詳情請參閱刪除帳戶與移除裝置。

我可以一次開啟多個螢幕嗎?

可以。一個工作區最多可同時顯示四個獨立畫面:可來自同一台已受信任 Mac 的多個顯示器、不同的 Mac,或兩者的組合。每個畫面都能選擇實體顯示器、重用與 Viewer 顯示區域大小相符的既有虛擬顯示器,或建立新的虛擬顯示器。重用虛擬顯示器時也會檢查更新率,不會選用以錯誤更新率運作的顯示器。

鍵盤與指標一次只會控制一個畫面,其他畫面仍持續傳輸。使用Request control可將控制權切換到正在觀看的畫面。兩個或更多畫面同時參與時,Reach 會對每條參與的串流套用工作區層級的影格率與位元率上限。每個畫面都建立自己的連線;上限取決於參與畫面數,而非共用連線。限制只影響目前的串流,不會改變已儲存的畫質設定;回到單一畫面後,上限便會解除。

即使影片流正常,音訊也是無聲的。

在 Reach Host → Permissions 開啟「Share system audio(分享系統音訊)」。Reach 透過 ScreenCaptureKit 擷取系統音訊;Reach Host 不要求麥克風權限,也會忽略麥克風取樣。若需修復權限,請使用 Reach Host 開啟的螢幕錄製與系統音訊設定。它擷取的是 Mac 的系統音訊輸出,不只是所選顯示器的音訊。麥克風輸入不會被擷取或錄製;此權限用於系統音訊。

Viewer 音訊會與顯示的影片時間軸同步。如果音畫偏差過大,Reach 會丟棄或重設過期的音訊佇列,而不是延遲播放。網路短暫不穩可能使一小段聲音遺失,但可避免整個工作階段持續不同步。

鍵盤不工作。

將 Magic Keyboard 或其他藍牙鍵盤連接到 iPhone 或 iPad。當目前畫面擁有控制權且處於焦點時,Reach 會將硬體鍵盤輸入傳送到該畫面。螢幕鍵盤仍可使用。如果無法輸入,請檢查 Mac 的輔助使用權限,在System Settings → Privacy & Security → Accessibility中授予權限後重新連線。

影片看起來模糊不清,或者幀掉落。

在區域網上,在同一子網上,直接連線提供低延遲。 如果這不是您看到的:(1)在Mac上首選乙太網,(2)保持在5 GHz或6E而不是2.4 GHz Wi-Fi上,(3)在側面板的實時設定下降低幀率或請求的位元率,(4)檢查後臺上傳是否吞噬了連結。 要更改解析度,請在連線前選擇一個尺寸或編輯預設,然後重新連線。 Reach流式傳輸硬體加速的HEVC和H.264,自適應位元率超過QUIC;如果HEVC在您的設定中不穩定,H.264是安全的後退。 請記住,中繼工作階段預計將增加路徑和網路依賴的延遲,如上所述,同時執行多個Surfaces會降低每個Surface的流上限。

如何取消裝置配對或重置信任?

Reach Host → Devices & Trust → Devices列出所有受信任的 Viewer 及其指紋。移除項目會撤銷配對,並關閉該 Viewer 所擁有的進行中工作階段。相同指紋也無法透過 Reach 帳戶或 iCloud 自動重新取得信任;若要再次信任該裝置,必須明確輸入新的配對碼。若還要撤銷該裝置在帳戶中的註冊,請從帳戶頁面移除裝置。登出只會結束該裝置的登入狀態,不等於撤銷註冊。

為什麼實體鍵盤上的 Caps Lock 會切換輸入法,而不是鎖定大寫字母?

Reach 會將連接至 iPhone 或 iPad 的實體鍵盤上的 Caps Lock 按鍵,當作 Mac 的輸入來源切換操作傳送。如果 Mac 設有韓文和英文輸入來源,按鍵會在兩者之間切換。其他輸入來源組合則依 Mac 的設定運作。iPadOS 會把 Caps Lock 當成立即切換操作傳遞,因此沒有長按操作。若要鎖定大寫字母,請使用螢幕鍵盤上的 Caps Lock。

畫面上浮著一個小圓形控制柄。這是什麼?

那是游標控制柄。在 Direct Touch 模式中,它會跟隨 Mac 游標;您可以拖移它,精準移動指標,不必反覆點按尋找位置。如果只想在自己的 Viewer 關閉,請在連線時的側邊面板選擇「Touch input」→「Cursor handle」。若要對所有 Viewer 停用,請使用 Mac 上的 Reach Host → Devices & Trust → Advanced → Cursor Telemetry → Share cursor position with viewer。Mac 端的設定會跨工作階段保留;停用後 Viewer 會立即清除控制柄。

我如何反轉滾動方向?

開啟工作階段中側板並找到 滾動方向. 反轉觸控滾動 和 反轉觸控板滾動 是單獨的開關,因此您可以在不更改觸控板滾動的情況下翻轉雙指觸控滾動,或者反過來。

我從哪裡獲得這些應用程式?

Reach Viewer透過App Store作為 Reach Remote: Apps.apple.com/app/id6762804458。 Reach Host,Mac側,是從本網站下載的免費公證DMG;一旦安裝,它會自動檢查更新,並在選單中提供安裝操作。

日誌在哪裡,如果您需要它們來報告錯誤?

在 Mac 上開啟Reach Host → Devices & Trust → Advanced → Host activity log,使用Copy複製活動日誌,或使用Export…儲存為 .txt 檔案。在 iPhone 或 iPad 上連線失敗時,失敗提示卡提供Copy Report。報告包含連線路徑、耗時和錯誤等嘗試資訊,識別資訊已遮蔽,不含螢幕內容。請將可取得的日誌或報告附在 GitHub issue 或電子郵件中。

報告和聯絡

連線失敗後請立即複製支援報告,以保留連線路徑與時間資訊。公開張貼前移除 Token、配對碼、電子郵件、公用 IP 及私人畫面內容。

  • Host 與 Viewer 的版本和建置編號
  • 裝置、作業系統版本及連線路徑:Nearby/Direct/Relay
  • 畫面數量與發生問題的 Mac
  • 發生時間與時區、重現步驟及完整錯誤資訊

選擇公共或私人頻道。

使用GitHub問題處理錯誤和功能請求;使用電子郵件處理帳戶或隱私問題。

螢幕截圖