サポート

つながるまで、お手伝いします。

ペアリング、表示の問題、操作、リモート接続についてのヘルプです。

はじめに

Mac 版 2.1（macOS 14 以降）をダウンロードし、iPhone・iPad 版 MeowDisplay を App Store から入手します（iOS または iPadOS 16.4 以降）。インストール、アクセス許可、最初の接続については、セットアップガイドで説明しています。

受信側アプリを開いたままにし、両方のアプリに互換性があることを確認します。Mac 版と iOS 版の 2.1 は一般公開されています。Android 2.0 は Google Play のクローズドテスト中で、Mac 版 2.0 以降と組み合わせて使えます。

Android ベータ版

Android 2.0 の受信側アプリは Google Play のクローズドテスト参加者が利用でき、Mac 版 2.0 以降と組み合わせて使えます。Mac 2.1 では、Mac のロック中は Android の画面が暗くなり、Mac 本体でロックを解除すると元に戻ります。Android アーリーアクセスプログラムに参加し、同じアカウントで Google Play のテストへの参加を登録してから、非公開のベータ版をインストールします。ライブセッションには Mac の送信側アプリが必要です。「Try the Demo」はオフラインでも動作します。

Android は USB に対応していません。ローカル Wi-Fi またはプライベートネットワーク（Tailscale など）で接続します。信頼されたセッションを開始する前に、デバイスをペアリングしておく必要があります。バグを報告するときは、Android のバージョン、スマートフォンまたはタブレットの機種、実機とエミュレータのどちらでテストしたかを記載してください。

ペアリング

両方のデバイスでコードを見比べ、一致した場合にのみ承認します。以前に信頼したデバイスに予期せず「Pair」と表示される場合は、まず両方のアプリを再起動します。それでも解決しない場合は、あえて「Forget Device」でそのデバイスの登録を解除してから、もう一度ペアリングします。

両方の画面を確認せずに、予期しないペアリング要求を承認しないでください。

macOS 15：ペアリングを承認した直後に Mac アプリが終了する場合、これは既知の問題です（#219）。MeowDisplay 2.1 には修正案が含まれていますが、macOS 15 ではまだ検証されていません。試せる場合は、結果をこの Issue に書き込んでください。Tailscale 経由での失敗については、引き続き調査中です。

ミラーリングと拡張

画面が真っ暗になる：Mac で画面収録が許可されているか、ストリームが接続中で一時停止していないかを確認します。

「Mirror」を使えない：使用中の物理ディスプレイが必要です。使用中の外部ディスプレイがない状態でノートブックの蓋を閉じていると、物理ディスプレイを利用できない場合があります。代わりに Extend を選択してください。「Extend」は独自のディスプレイを作成するため、ダミーアダプタは必要ありません。

蓋を閉じるとセッションが止まる：クラムシェルモードで使うときは、MacBook を電源に接続したままにし、iPhone または iPad で Extend を使います。

「Extend」を使えない：ビデオキャプチャを有効にします。「Displays」を開いて「Extend」を選択し、「Arrange Displays…」で追加の画面がどこに配置されているかを確認します。

オーディオ

セッションが接続中で再生されていることを確認してから、受信側デバイスの音量と Mac のオーディオ出力を確認します。オーディオは受信側デバイスから開始します。状態は Mac アプリの「Streaming」設定で確認できます。受信側にライブセッションではなく古いフレームが表示されている場合は、再接続してください。

入力とジェスチャ

Mac でアクセシビリティの許可を与え、Allow Input を有効にして、一時停止中のストリームがあれば再開します。タップとドラッグは1本指、スクロールは2本指で操作します。3本指でタップすると Spotlight が開きます。

それでも入力できない場合は、アクセス許可を変更したあとにアプリを開き直します。「Natural Touch」「Classic」「Trackpad」「Window view」のどれを使っていたかも控えておいてください。接続しただけで入力が許可されることはありません。受信側で「Request Control」を使います。報告するときは、使ったジェスチャやキーボード操作と、「Mirror」「Extend」「Window view」のどれを使っていたかを記載してください。

Window view とフローティングウインドウ

「Float」の項目が表示されない：フローティングウインドウを使うには、Mac と iPhone または iPad の両方に MeowDisplay 2.1 が必要で、「Settings ▸ Controls ▸ Window Switcher」の Enable Floating Windows がオンになっている必要があります。Android と Mac Receiver では使えません。

フローティングウインドウが消えた：画面の端に細い帯がないか探して、タップします。同じ端に複数のフローティングウインドウが集まっている場合は、ひとつの帯にまとめられています。タップすると、それらのウインドウのメニューが表示されます。フローティングウインドウに対応していない Mac に接続しているあいだは、フローティングウインドウは端にしまわれたままになり、対応している Mac に接続すると使えるようになります。

フローティングウインドウのサイズを変えても Mac のウインドウが変わらない：これは想定どおりの動作です。角のつまみで変わるのは、デバイス上の表示だけです。実際のウインドウのサイズを変えるには Fill Window on Mac を使います。Mac の操作が許可されていることと、Mac に MeowDisplay 2.1 が入っていることが必要です。Restore Previous Size on Mac は、戻せるサイズがある場合に表示されます。

ペイン内の「開く」または「保存」パネルが反応しない：Mac に MeowDisplay 2.1 が入っていれば、これらのパネルは表示されている位置でタップを受け付けます。パネルのボタンが MeowDisplay のコントロールに隠れている場合は、Esc キーでキャンセル、Return キーで確定できます。

「No … Window to Show」と表示される：そのアプリは Mac で開いていますが、ウインドウがありません。Show a Window on Mac を選ぶと、Mac 上でアプリが前面に移動し、ウインドウが開きます。または Choose a Window を選択します。

「This pane’s window was closed on the Mac.」と表示される：Choose Window を選ぶと、そのペインに別のウインドウを表示できます。ペインを削除するには Remove Pane を選択します。

ペインに Mission Control のため一時停止中と表示される：Mac で Mission Control が開いています。Exit Mission Control を選択するか、Mac で Esc キーを押します。

使い方は Window view とフローティングウインドウを参照してください。

キーボード

入力した文字が Mac に届かない：先に操作を許可してもらう必要があります。受信側で「Request Control」を使います。「Window view」では、入力したいウインドウを先にタッチして、最前面にします。

「Zoom While Typing」の位置がずれる：この機能は Mac が報告する入力位置に従うため、アプリによってはずれることがあります。キーボードを閉じてから開き直すか、ピンチで表示を調整するか、「Settings ▸ Input ▸ Keyboard」で Zoom While Typing をオフにします。

矢印キーパッドの ⇧ ⌥ ⌘ が淡色表示になる：Mac 側が古いバージョンの場合、これらのキーは「Control Tray」で修飾キーを固定していないときにのみ使えます。トレイの修飾キーの固定を解除するか、Mac の MeowDisplay をアップデートしてください。

Mac がロックされているとき

Mac のロック中は、通常のセッションの内容は表示も送信もされず、デバイスには Mac がロックされていることが表示されます。許可された iPhone や iPad では、その場合でもロック画面の表示を要求できます。ロックが解除されると、レイアウトが元に戻ります。

「Show Lock Screen」ボタンがない：そのデバイスには Mac のロック画面の使用が許可されておらず、その理由が表示されます。Mac 本体でロックを解除してください。次回から使えるようにするには、Mac で Always Allow Requests に設定し、Allow Input をオンに、そのデバイスの Allow Lock Screen Control をオンにして、両方に MeowDisplay 2.1 を入れておく必要があります。Ask の場合は、Mac がロックされる前にそのデバイスに操作が許可されていたときにのみ使えます。

ロック画面が閉じた：ロック画面は、入力がないまま2分経過したとき、接続が切れたとき、Mac のロックが解除されたときに終了します。もう一度「Show Lock Screen」をタップしてください。

仕組みについては Mac のロックとロック解除を参照してください。

USB とローカルネットワーク

iPhone・iPad の USB 接続：データ転送に対応したケーブルを使い、別のポートも試してください。デバイスのロックを解除し、「このコンピュータを信頼しますか？」と表示されたら「信頼」をタップします。Android での USB 接続は実装されていません。

Wi-Fi：両方のデバイスでローカルネットワークへのアクセスを許可し、受信側アプリを開いたままにして、両方が同じネットワークに接続されていることを確認します。ゲストネットワークの分離機能やファイアウォールのルールによって、検出や接続ができない場合があります。

経路ラベルは、現在の接続経路（USB、LAN、または近距離ピアツーピアの AWDL）を示します。問題を報告するときは、このラベルも記載してください。

新しいデバイスを承認した直後に Mac アプリが終了する：macOS 15 での既知の問題です（#219）。MeowDisplay 2.1 には、原因のひとつである、接続に QUIC を使う場合に対する修正案が含まれています。この修正は、macOS 15 ではまだ検証されていません。それでも問題が起きる場合は、Mac のログをこの Issue に追加してください。

Remote Access とスリープ解除

プライベートネットワーク上で両方のデバイスがオンラインになっていること、保存したリモートエンドポイントが最新であることを確認します。アドレスに到達できても、信頼済みのペアリングの代わりにはなりません。

「Wake & Connect」には、対応するハードウェアと「ネットワークアクセスによるスリープ解除」の設定が必要です。ローカルの Wake-on-LAN は、到達できないスリープ中の Mac 自身の Tailscale 接続を通過できません。リモートからスリープ解除するには、その Mac と同じ LAN 上に別のデバイスまたはルーターが必要です。

電源オフからの起動（コールドブート）や、完全にログアウトした Mac は、現在サポートしているセッションのワークフローの対象外です。Remote Access の設定を参照してください。

問題を報告する

Mac では Logs を使って診断ファイルを表示します。iOS では Settings & Help → Connection log を開くか、デバイスを振ります。

共有する前に、非公開のエンドポイント、識別子、デバイス名、個人的な内容を削除してください。Android では「Settings & Help → Share Connection Log」を使います。実機でのテストか、自動テストやエミュレータでのテストかを区別して記載してください。

GitHub で Issue を作成 ↗

  • アプリのバージョン（ダウンロード版、App Store 版、Google Play のクローズドテスト版、ソースからのビルド）と、macOS、iOS、Android のバージョン。
  • Mac と受信側デバイスの機種、モード、現在の接続経路。
  • 行った操作、期待した結果、実際に起きたこと。
  • 再起動や再接続で結果が変わるかどうか。

セキュリティ上の問題の報告

セキュリティやプライバシーの脆弱性を見つけた場合：公開の GitHub Issue は作成しないでください。代わりに、MeowDisplay リポジトリで、GitHub の非公開の Report a vulnerability 機能を使ってください。

MeowDisplay リポジトリの「Security」ページを開き、Report a vulnerability を選択します。送信した内容はメンテナだけが見られます。記載すべき内容については、セキュリティポリシーで説明しています。

問い合わせ先

  • バグ報告と機能リクエスト：公開の GitHub Issue。
  • 一般的なヘルプ：このページとセットアップ。
  • セキュリティやプライバシーの脆弱性：上記の、GitHub の非公開の脆弱性報告機能。

MeowDisplay がデータをどのように保存・送信するかについては、プライバシーをご覧ください。