ロック画面入力コールバックの有効化¶

ホスト PC が Windows のロック画面に切り替わると、OS のセキュリティポリシーにより OS レベルのキーボードおよびマウス入力がブロックされます。リモート環境では画面と音声のストリーミングは可能ですが、実際のゲーム操作はできない状態になります。

従来は、リモートユーザーが Windows アカウントのパスワードを入力してロックを解除する必要がありました。ただし、この方法には PC 全体の制御権限が露出するリスクと、接続手順が煩雑になる問題がありました。

Remote Play Plugin は、Hive Console の Remote Play 設定で ロック画面を解除せずにプレイ 機能を提供します。この機能を有効化すると、キーボード、マウス、タッチ、ジョイスティック、ホイール、ズームなどのすべての入力イベントが ゲームコールバック に直接渡されます。

主な動作¶

• コールバックベースの配信: すべての入力イベントは RegisterCallback で登録されたコールバック関数に eventType: "Control" として渡されます。ロック状態に関係なく同じように動作し、ロック解除後もコールバック配信は維持されます。
• OS 入力経路の迂回: OS の SendInput 経路は使用されません。Windows のロック状態に関係なく、一貫した入力イベントを受信します。
• ゲームへの直接注入: ゲームはコールバックで受信した入力データを内部入力システムに直接注入し、ロック状態と通常状態の両方で同じ操作を処理します。

事前準備¶

この機能を適用する前に、以下を準備してください。

• Remote Play Plugin のインポート
• イベント受信用コールバック関数の登録
• 対応 SDK / プラグインバージョン:
  • Remote Play Plugin 1.2.0 以上
  • Hive SDK v4 26.4.0 以上

Control イベントプロトコル¶

ロック画面を解除せずにプレイ 機能を有効化した後、コールバックで渡される入力イベントは チャットイベント と同じ JSON 形式で渡され、eventType の値は "Control" に固定されます。実際の入力種類は内部の controlType で区別します。

Envelope 共通構造¶

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "<Key | Click | Wheel | Zoom>",
            "controlValue": {
                "value"  : "<controlType-specific-value>",
                "action" : "<controlType-specific-action>"
            }
        }
    },
    "etc"       : { }
}

controlType = "Key" - キーボード入力¶

キーボード単一キーの押下または解放状態を渡します。Web クライアントで発生したキーボード入力とジョイスティック入力はいずれも controlType に変換されます。

ジョイスティックの方向コードは、マッピング設定（WASD / DIRECTION）に従って単一キーイベントに分解され、controlType として渡されます。ゲーム側ではキー入力とジョイスティック入力が同じ形式に見えます。斜め移動もホストが 2 つの単一キーイベントに分解して送信します。

例 - 'A' キー押下

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Key",
            "controlValue": { "value": "0x41", "action": "Down" }
        }
    },
    "etc"       : { }
}

例 - ジョイスティック上（WASD マッピング時の 'W' キー）

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Key",
            "controlValue": { "value": "0x57", "action": "Down" }
        }
    },
    "etc"       : { }
}

controlType = "Click" - マウスおよびタッチ座標入力¶

マウスクリック、マウス移動、タッチ座標を渡します。Web クライアントで発生したマウス入力とタッチ入力はいずれも、GetClientRect() を基準としたゲームウィンドウのクライアント領域ピクセル座標に自動変換されて渡されます。

座標変換の参考¶

curWidth / curHeight は、ゲームウィンドウの GetClientRect() を基準としたクライアント領域サイズです。そのため、ゲームではウィンドウ座標としてそのまま適用してください。

例 - マウスクリック（Down -> Up）

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Click",
            "controlValue": { "value": "526.5#792.5", "action": "Down" }
        }
    },
    "etc"       : { }
}

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Click",
            "controlValue": { "value": "526.5#792.5", "action": "Up" }
        }
    },
    "etc"       : { }
}

例 - ドラッグ（Move）

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Click",
            "controlValue": { "value": "645.1#681.7", "action": "Move" }
        }
    },
    "etc"       : { }
}

controlType = "Wheel" - マウスホイール¶

マウスホイールのスクロール動作を渡します。

例 - ホイールダウン（マウス位置 1234.0 px, 567.0 px）

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Wheel",
            "controlValue": { "value": "1234.0#567.0", "action": "Down" }
        }
    },
    "etc"       : { }
}

controlType = "Zoom" - ズームイン/アウト¶

カメラまたはマップ画面のズームイン/アウト動作を渡します。

例 - ズームイン

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Zoom",
            "controlValue": { "value": "1", "action": "In" }
        }
    },
    "etc"       : { }
}

例 - ズームアウト

{
    "version"   : "1.02.00",
    "eventType" : "Control",
    "eventValue": {
        "value": {
            "controlType" : "Zoom",
            "controlValue": { "value": "1", "action": "Out" }
        }
    },
    "etc"       : { }
}

入力タイプ変換マッピング概要¶

Web クライアントが送信した元の入力タイプが、ホストのコールバックイベントに変換されるマッピング構造です。

ステータス（Event）/ チャット（Message）イベントは、この Control イベントでは渡されず、既存のプロトコル仕様に従って別途渡されます。

ゲーム側の入力処理ガイド¶

Hive Console の Remote Play 設定で ロック画面を解除せずにプレイ 機能を有効化すると、Remote Play は入力イベントを OS の入力キューに送信せず、登録されたコールバックを通じてゲームに直接渡します。

そのため、コールバックで受信した入力イベントは、Unity Input System や Unreal Input Subsystem など、ゲーム内部の入力システムに直接渡して処理する必要があります。

この方式は、Windows のロック画面環境で SendInput や SendKey などの OS レベル入力注入が制限される問題を迂回するための構造です。入力イベントはゲームプロセス内部で直接ディスパッチされるため、ロック画面状態と通常状態を区別せず、同じ処理経路を使用することを推奨します。

つまり、ロック画面を解除せずにプレイ 機能を有効化した後は、このコールバックで渡されるすべての入力イベントを受信し、ゲームの内部入力システムに渡す方式で実装することが望ましいです。これにより、ロック画面状態に関係なく一貫した入力処理とリモートプレイ動作を保証できます。

• Unity: InputSystem.QueueEvent または独自の入力マネージャーでディスパッチ
• Unreal Engine: FSlateApplication::OnKeyDown / OnMouseButtonDown などの Slate イベントでディスパッチするか、ゲーム独自の入力マネージャーを使用

ロック画面環境でのバックグラウンドレンダリングとオーディオ処理ガイド¶

Windows のロック画面環境で Remote Play を使用するには、ゲームがバックグラウンド状態でも正常に動作できる必要があります。多くのゲームエンジンはフォーカスを失ったりバックグラウンド状態に切り替わったりすると、CPU 使用量を抑えるためにレンダリングを停止またはフレームを制限し、オーディオ再生も一時停止します。リモートストリーミングを正常に維持するには、ゲームプロセスがバックグラウンドでも動作するように設定を変更する必要があります。

1. Remote Play 接続状態に応じた推奨ポリシー¶

ゲームは Remote Play の接続状態を確認し、リモートユーザーが接続中かどうかを判断する必要があります。推奨動作は以下のとおりです。

接続状態は ステータスイベントコールバック（eventType: "Event"、value REMOTE_PLAY_CONNECTED / REMOTE_PLAY_DISCONNECTED）で判定できます。

2. バックグラウンドレンダリングの維持¶

ロック画面状態でも Remote Play が画面をキャプチャできるように、レンダリングループを継続して動作させる必要があります。確認項目の例は以下のとおりです。

• フレーム更新を停止しない
• レンダーループを維持する
• カメラレンダリングを維持する
• UI 更新を維持する
• バックグラウンドフレーム制限ポリシーを確認する

3. バックグラウンドオーディオ出力の維持¶

Remote Play はゲームプロセスから出力されるオーディオをキャプチャし、リモートプレイヤーに配信します。そのため、以下のようなバックグラウンドオーディオ遮断ポリシーを無効化する必要があります。

• Focus Lost 時のオーディオ一時停止
• Window Deactivate 時の Audio Engine 停止
• Background Mute 機能の有効化

エンジン別の確認事項と参考¶

Unity¶

Unity はデフォルトでバックグラウンド移行時に更新を制限する場合があります。ロック画面 Remote Play 機能を使用する場合は、以下のようにバックグラウンド実行を有効化することを推奨します。

Application.runInBackground = true;

フォーカス喪失時にオーディオを停止するカスタムロジックがある場合は、Remote Play の接続状態を考慮して例外処理してください。

Unreal Engine¶

Unreal Engine プロジェクトでも、フォーカス喪失時に Tick、レンダリング、またはオーディオ処理を制限する設定が適用されていないか確認する必要があります。特に以下の項目を確認することを推奨します。

• Background Tick の動作有無
• Focus Lost 時の Pause 処理有無
• Audio Mixer の動作有無
• バックグラウンド FPS 制限ポリシー

Remote Play 接続中は、バックグラウンド状態でも正常なゲームループが維持されるように実装する必要があります。

推奨動作シナリオ¶

1. ユーザーが Windows のロック画面状態に切り替える
2. Remote Play クライアントが接続する
3. ゲームが接続状態を検知し、バックグラウンドレンダリングおよびオーディオ出力を維持する
   • ゲームレンダリングを継続
   • ゲームオーディオ出力を継続
4. Remote Play Plugin が画面とオーディオを正常にキャプチャして送信する
5. リモートユーザーがゲーム画面とサウンドをリアルタイムで受信する
6. 入力イベントは Remote Play 入力 Control コールバックを通じてゲーム内部の入力システムに渡される

関連ドキュメント¶

• イベント受信用コールバック関数の登録
• ブラインド画像の変更