接続に必要なネットワーク条件
現在の CodexPocket は、同じローカルネットワークの中で使う前提です。Mac の前にいないときでも iPhone から操作できますが、インターネット越しの接続はこのリリースでは扱いません。
基本条件
- Mac と iPhone が同じネットワークにいる
- Mac 側の Bridge が起動している
- iPhone でローカルネットワークが許可されている
- QR を読むなら iPhone でカメラが許可されている
- Mac がスリープしていない
接続の仕組み
CodexPocket は、主に次の 2 つで Mac を見つけます。
- Bonjour
- ローカル URL
ペアリングで iPhone に渡されるのは、この接続候補と接続用トークンです。通常は意識しなくて構いませんが、仕組みとしては「同じネットワーク内で見える Mac を探し、見つかった接続先へつなぐ」と考えると分かりやすくなります。
手入力で追加するときは、Bridge URL に http://<bridge-host>:43123 の形を入れるのが基本です。
つながりやすいネットワーク
- 自宅の Wi-Fi
- 端末同士の通信が許可されている社内 LAN
- Mac と iPhone が同じセグメントにいる検証用ネットワーク
Wi-Fi 名が同じでも、端末同士の通信が遮断されているネットワークではつながりません。
つながりにくくなる例
- Mac と iPhone が別の Wi-Fi にいる
- iPhone がモバイル回線側に逃げている
- ゲスト Wi-Fi などで端末間通信が制限されている
- VPN やネットワーク設定の影響で Bonjour やローカル URL に届かない
- iPhone 側でローカルネットワークを拒否している
- Mac がスリープしている
- Bridge が止まっている
このページで扱わない接続
- インターネット越しの接続
- リレー経由の接続
- 将来のバックエンド構成
まずは「同じ場所の同じネットワークで使う」と考えるのがいちばん確実です。うまくいかないときも、最初にここへ立ち返ると原因を切り分けやすくなります。