KVMチュートリアル 02 — 基本操作

対象: 初級〜中級 — 日常使用機能

1. マウスコントロール

絶対モード（デフォルト）

ホストのマウスカーソルがターゲット画面に直接マッピングされます。両方のカーソルが表示されます。

最適な用途: 一般的な使用、サーバー管理、BIOSナビゲーション
カーソルの動作: 自動非表示、またはビデオ領域上にホストカーソルを常時表示

相対 (HID) モード

マウスの移動はHIDインターフェースを通じて相対デルタとして送信されます。ホストカーソルは非表示になります。

最適な用途: ゲーミング、生のマウス入力が必要なアプリケーション
要件: macOSでのアクセシビリティ許可権
終了: グローバルキーボードショートカット（macOS）またはEsc長押し（Qt）

Androidマウスモード

Androidアプリは設定パネルで切り替え可能な、ターゲットマウスを制御する3つの方法を提供します：

モード	動作	最適な用途
絶対（デフォルト）	任意の場所をタップするとカーソルがそこにジャンプし左クリック。位置は比例マッピング。	ほとんどのタスク
相対	指をドラッグするとカーソルがドラッグに対して相対的に移動。ノートPCのトラックパッドのように。指を離すとカーソルはそのまま。	精密なカーソル配置
絶対ドラッグ	タップ＆ホールド。カーソルがジャンプして指に追従。「Drag」ラベルが表示。離すとドロップ。	ファイルのドラッグ、テキスト選択

Androidのマウスボタン: シングルタップ = 左クリック、長押し = 右クリック、ダブルタップ = ダブルクリック。

iPadOSマウスモード

iPadOSアプリは2つのマウスモードを提供し、ツールバーのマウスモードボタンで切り替え可能：

モード	アイコン	動作	最適な用途
Pan Mode（相対）	手のアイコン	指がノートPCのトラックパッドのように — ドラッグでカーソル移動、タップでクリック	一般的なデスクトップ使用、平らな面
iPencil Mode（絶対）	ペンシルアイコン	タッチ位置がターゲット画面座標に直接マッピング。描画タブレットのように	精密なポインティング、Apple Pencil使用

両モードのジェスチャー:

ジェスチャー	Pan Mode	iPencil Mode
シングルタップ	左クリック	カーソルをポイントに移動＋左クリック
タップ＆ドラッグ	カーソル移動（相対）	左ボタン押下のままドラッグ
ダブルタップ	ダブルクリック	ポイントでダブルクリック
長押し	右クリック	ポイントで右クリック
2本指タップ	右クリック	右クリック
2本指ドラッグ	スクロールホイール	スクロールホイール

クイックメニュー: ビデオプレビューを長押しすると、Left Click、Right Click、Dragオプションのメニューが開きます。

ドラッグモード: ダブルタップ＆ホールド、またはクイックメニューからDragを選択 — 左ボタンが押されたまま、「Dragging Mode Active」ラベルが表示されます。

パフォーマンスプリセット（macOS）

Control > Mouse Mode > Performance Presets の下：

プリセット	スロットル	ボーレート	使用例
Low Performance Target	30 Hz	9600	低速ターゲットデバイス
Casual Use	80 Hz	9600	日常のサーバー管理
Gaming	250 Hz	115200	レスポンシブなゲーミング
Max Performance	1000 Hz	115200	最大レスポンス

スロットルが高い = よりレスポンシブ。ボーレートが高い = より高速なシリアル通信。

2. キーボード入力

標準入力

アプリウィンドウがフォーカスされている間、入力されたすべてのキーストロークがターゲットに転送されます。

特殊キー

ツールバーのキーパネルまたは Control > Special Keys からキーの組み合わせを送信：

F1–F12: ファンクションキー
Ctrl+Alt+Del: Windowsの3本指サルート
Print Screen: スクリーンショットキー
Ctrl+Alt+F2: Linux VT切り替え

キーボードレイアウト

ターゲットOSのレイアウトをターゲットコンピュータに合わせて設定：

レイアウト	動作
Windows	ホストキーをWindowsの慣例にマッピング
Mac	ホストキーをMacの慣例にマッピング
Linux	ホストキーをLinuxの慣例にマッピング

地域レイアウト（QWERTY UK、デンマーク語、QWERTZドイツ語、AZERTYフランス語、日本語など）もQtアプリケーションで利用可能です。

ターゲットへのペースト

アプリはクリップボードテキストをエミュレートされたキーストロークとしてターゲットに送信します。ユーザー名、コマンド、URLに便利です。

注意: ASCII文字のみサポート。長いテキストは古い/ビジーなシステムで書式が失われたり文字が落ちたりする場合があります。

ペースト動作の設定（macOS）:

Ask Every Time: 毎回ホストまたはターゲットをプロンプト
Host Paste: 常にターゲットに送信
Local Paste: 常にホストにペースト

Androidオンスクリーンキーボード

Androidアプリは、メイン画面右下のキーボードボタン（⌨）からアクセスできる完全なオンスクリーンキーボードを提供します：

コントロール	機能
ShortCut	プリビルトショートカット: Ctrl+C/V、Win+L、Ctrl+Alt+Del、Alt+F4 など
Function	F1–F12、PrtSc、ScrLk、ナビゲーションキー（Ins、Home、PgUp など）、矢印キー
System	文字、数字、句読点、Backspace、Enterを含むQWERTYレイアウト
Modifier keys	Ctrl、Shift、Alt、Win — 次のキー送信後に自動リセットするトグルボタン

Ctrl+Alt+Del などの組み合わせを送信: Ctrlをタップ（ハイライト）、Altをタップ（両方ハイライト）、Delをタップ。キー送信後、すべてのモディファイアが自動リセットされます。

キーボードは異なる地域レイアウト（US、日本語JIS、ドイツ語QWERTZなど）もサポートし、設定パネルで選択可能です。ズームイン/アウトボタンでキーサイズを調整できます。

iPadOSキーボード入力

iPadOSアプリは2つのキーボード入力方法をサポートします：

フローティングオンスクリーンキーボード: ツールバーの Keyboard ボタンをタップすると、Macスタイルのドラッグ可能なフローティングキーボードが表示されます：

行	キー
Top	Esc、F1–F12、Del
Number	`、1–0、-、=、Backspace
QWERTY	Tab、q–p、[、]、\、Enter
Home row	Caps、a–l、;、'、Enter
Bottom	Shift、z–m、,、.、/、Shift
Modifiers	Ctrl、Alt、Cmd、Space、Cmd、Alt、Ctrl

モディファイアのトグル: Ctrl、Shift、Alt、Cmd、またはCapsをタップしてオン/オフ切り替え（青でハイライト）
キーボードモード: Normal（標準入力）とGame（ゲーム入力向けに最適化されたHIDパケットヘッダー）
ドラッグ: ヘッダーのドラッグハンドルを掴んでキーボードを画面内の任意の位置に移動

外付けiPadキーボード: iPadに接続された物理キーボード（Bluetooth、Smart Connector、USB）はターゲットPCに直接パススルーされます。モディファイアキーは押下/リリースイベントとして送信されるため、Ctrl+C や Alt+Tab などの組み合わせが自然に動作します。

複合キーショートカット: アプリにはツールバーからカテゴリ別にアクセスできる一般的なショートカットライブラリが含まれています：

カテゴリ	例
Navigation	Ctrl+C/V/X/A/F、Ctrl+Home/End、Page Up/Down
Editing	Ctrl+Z/Y、Ctrl+B/I/U、Ctrl+D
System	Ctrl+S/O/P/R、F11、Alt+F4
Application	Alt+Tab、Cmd+M、Cmd+Shift+3/4（macOSスクリーンショット）

3. ビデオ設定

解像度表示

ツールバーにターゲットからの現在の入力解像度とFPSが表示されます。解像度はターゲットがHDMI経由で出力する内容によって決まります。

サポート解像度

解像度	フレームレート範囲
640x480	5–60 Hz
720x480	5–60 Hz
800x600	5–60 Hz
1024x768	10–60 Hz
1280x720	10–60 Hz
1280x1024	5–30 Hz
1600x1200	5–30 Hz
1920x1080	5–30 Hz

解像度の変更

ビデオ設定で希望の解像度を設定する

アスペクト比とスケーリング

モード	動作
Active Resolution	アクティブなビデオ領域を自動検出
HID Resolution	キャプチャカードハードウェアからの解像度を使用
Custom	比率を手動設定（16:9、4:3、21:9 など）

スケーリング: Stretch（ウィンドウを埋める、歪む可能性あり）、Fit（レターボックス）、Fill（クロップする可能性あり）。

ズーム

ズームイン/アウト、フィットにリセット、ズーム中はスクロールでパン。

ビデオバックエンド（Qt）

バックエンド	プラットフォーム	備考
FFmpeg	All	推奨、ハードウェアアクセラレーション
GStreamer	Linux	パイプラインの柔軟性
Qt Multimedia	Windows	シンプルなフォールバック

Preferences > Video > Media Backend から切り替え。変更後は再起動が必要。

Androidビデオコントロール

Androidアプリでは、設定パネル（Menuボタン ☰）からビデオ設定にアクセス：

Video Format — 解像度（1920×1080、1280×720、640×480）とフレームレート（30fps、60fps）を選択。ビデオがカクつく場合は解像度/フレームレートを下げる。
Controls — brightness、contrast、hue のリアルタイムスライダー
Rotate/Flip — 90° CW/CCW回転、水平/垂直反転。KVMデバイスが上下逆または横向きに取り付けられている場合に便利

設定はセッション間で保持されます — 一度だけ設定すればOK。

iPadOSビデオコントロール

iPadOSでは、ビデオコントロールは下部ツールバーからアクセス：

Resolution Switching — Video ボタン（現在の解像度を表示）をタップして選択: 2160p (4K)、1080p（デフォルト）、720p、または480p。遅い接続では解像度を下げてパフォーマンス向上。
Zoom Mode — Zoom をタップしてズームモードに入り、2本指ピンチでズームイン。ズームインジケーターに現在のレベル（例: 2.5x）を表示。ズーム中は1本指ドラッグでビューポートをパン。Zoom を再度タップで終了。
Fullscreen — Fullscreen をタップしてツールバーを非表示にし、ビデオを全画面に拡張。左上の矢印ボタンで終了。
Screen Rotation — Rotate をタップして向き補正モードを循環（Normal、90° CW、180°、90° CCW）。KVM-Goドングルが横向きまたは上下逆に取り付けられている場合に便利。回転はライブプレビューと保存キャプチャの両方に適用。

カメラ起動中は「Starting Camera...」ローディングインジケーターが表示されます。カメラが接続されていないが許可権が付与されている場合、ガイド画像が表示されます。

4. ターゲットからのオーディオ

HDMIキャプチャチップはHDMI信号からオーディオを抽出し、ホストへのUSBオーディオ入力として提示します。

オーディオの有効化

オーディオアイコンをクリックするかオーディオ設定を開く
オーディオキャプチャを有効化
正しい入力デバイスを選択（例: 「OpenterfaceA」）
ホストの出力デバイスを選択

ほとんどのプラットフォームでオーディオはデフォルトで無効です。

音量コントロール

ターゲット側: ターゲットコンピュータで調整
ホスト側: キャプチャデバイス用のホストOSオーディオミキサーを使用

iPadOSオーディオモニタリング

iPadOSアプリでは、iPadのスピーカーまたはヘッドフォンを通じてターゲットPCのオーディオを聴けます：

ツールバーの Audio ボタン（スピーカーアイコン）をタップしてモニタリングを切り替え
アイコンの状態: 灰色の斜線スピーカー = 未承認、赤の斜線スピーカー = オフ、緑の波付きスピーカー = オン
初回使用時、アプリはマイク許可権を要求
オーディオはiPadスピーカーまたは接続されたヘッドフォン/Bluetoothオーディオで再生
録画中: フィードバック防止のためモニタリングオーディオは一時的にミュートされますが、オーディオは録画ファイルにキャプチャされます

5. スクリーンキャプチャと録画

スクリーンショット

ツールバーのカメラアイコンをクリック。画像はOSのデフォルトメディアフォルダに保存されます：

Linux: ~/Pictures
Windows: C:\Users\<name>\Pictures
macOS: Camera capturesフォルダ（Cameraメニュー経由）

録画

録画ボタンをクリックしてターゲットのビデオとオーディオストリームの録画を開始/停止。録画中はタイマーが表示されます。

録画設定:

出力形式（MP4、AVI、MOV、MKV）
ビデオビットレート、オーディオコーデック
出力ディレクトリ

Androidスクリーンキャプチャと録画

Androidでは設定パネルからアクセス：

Screen Capture — タップして現在のビデオフレームのスナップショットをデバイスのデフォルトメディアフォルダに保存。Storage permission が必要。
Record Video — タップして録画開始/停止。上部にタイマー付きの赤い録画インジケーターが表示。ビデオはデバイスのデフォルトメディアフォルダに保存。

使用例: ターゲットのブートプロセスの録画、エラーメッセージのキャプチャ、設定手順の文書化。

iPadOSスクリーンキャプチャと録画

スクリーンショット: ツールバーの Screenshot ボタン（カメラアイコン）をタップ。アプリは高解像度フレームをキャプチャし、向きを補正してJPEGとして保存。

ビデオ録画: Record ボタンをタップして開始/停止。停止後、アプリは録画の詳細（時間とファイルサイズ）を表示。

設定	値
Video codec	H.264 at 30 fps
Resolution	キャプチャデバイスに一致（通常1920×1080）
Audio codec	AAC at 128 kbps, 48 kHz, stereo
Container	MOV

ファイルの場所:

App Documents: Documents/Recordings/ — Filesアプリ > On My iPad > Openterface KVM > Recordings から閲覧
Photos App: Photo Library許可権が付与され設定で有効な場合
ファイル名: Openterface_YYYY-MM-DD_HH-mm-ss.jpg（スクリーンショット）または .mov（録画）

使用例: ターゲットのブートプロセスの録画、エラーメッセージのキャプチャ、設定手順の文書化。

6. 接続インジケーター

インジケーター	緑	オレンジ	グレー
HDMI	信号検出	信号なし	不明
Keyboard	接続	見つからない	不明
Mouse	接続	見つからない	不明

USBスイッチ

USBスイッチトグルは、スイッチ可能ポートが Host または Target のどちらにルーティングされているかを表示します。

7. スクリーンセーバー防止

Prevent Screen Saver を有効化（Edit/Deviceメニューまたはツールバー経由）して、ターゲットディスプレイを起きたままにする定期的なイベントを送信します。

8. フルスクリーンモード

標準のフルスクリーンボタンを使用して、UIクロームを非表示にし、ビデオ領域でディスプレイ全体を埋めます。

次のステップ

高度な機能 → — EDID、ファームウェア、マクロ、スクリプト、診断
トラブルシューティング → — よくある問題と解決策