Remote Control C++ API

Remote Control C++ API を使用してエンジンをリモートでコントロールする方法について説明します。

Choose your operating system:

Windows

macOS

Linux

Remote Control C++ API を使用すると、Remote Control プラグインのさまざまな部分にアクセスできます。Unreal Engine では、カスタム統合およびリモート コントロール アダプターを作成して、カスタム トランスポートを使用してリモート コントロール エンティティにアクセスすることができます。

このページでは、Remote Control C++ API の概要を説明し、詳細を記載した「Unreal Engine C++ API リファレンス」へのリンクも提示します。

ワークフロー

  1. Unreal Engine と C++ アプリケーションとの間でデータを送受信できるように、Unreal Engine プロジェクトでサーバーを設定します。たとえば、 FUdpSocketBuilder および FIPv4Endpoint を使用できます。

  2. Unreal Engine プロジェクトでサーバーとデータを送受信するための外部の C++ アプリケーションを作成します。

  3. Unreal Engine プロジェクトで、受信したデータを処理し、リモート コントロール機能を呼び出すパーサーとマネージャーを作成します。

API

Remote Control C++ API のコア機能を構成しているクラスは、次のとおりです。

  • IRemoteControlModule :リモート コントロール プリセットの取得や解決など、 モジュール スコープで使用可能なアクセス機能

  • URemoteControlPreset:次へのアクセスを含みます。

    • 公開されている関数、プロパティ、およびアクタを含むターゲットへのアクセス。

    • プロパティ、関数、アクタなどの公開されているエンティティに一意の ID およびラベルを使用しているゲッターへのアクセス。このアクセスにより、エディタ、ゲーム モード、シミュレーション、パッケージからエンティティにアクセスできます。

    • プロパティ変更のリスナーへのアクセス。

    • エンティティが公開されているか、未公開である場合のデリゲートのアクセス。

  • FRemoteControlEntity:公開済みのオブジェクト、プロパティ、関数、アクタ、およびそれらのメタデータへのアクセス。

  • FRemoteControlProperty:リモート コントロールに公開されているプロパティを表現し、公開されているプロパティの値を取得したり、設定したりするための FProperty および RemoteControlPropertyHandle へのアクセスを含む。

  • FRemoteControlFunction: UFunction ポインタおよび関数の引数へのアクセス。これにより、 UObject->ProcessEvent(UFunction*, ArgumentsMemory) を使用して、特定のオブジェクトでこの関数を呼び出すことができます。

  • FRemoteControlActor:公開されているアクタのポインタへのアクセス。

  • IRemoteControlPropertyHandle:公開されているプロパティの値を変更するためのゲッターとセッターへのアクセス、および複合型の子プロパティへのアクセス。

単純型のプロパティの値を直接取得したり設定したりできます。単純型のプロパティには、int、float、double、string、vector、rotator が含まれます。

TArray、TMap、TSet、Structs などの複合型のプロパティ値を直接取得したり設定したりすることはできません。複合型では、子プロパティのハンドルにアクセスする必要があります。代わりに、子プロパティ ハンドルにアクセスする必要があります。子プロパティが単純なプロパティ タイプの場合は、その値を取得および設定できます。

  • Module:DisplayClusterRemoteControlInterceptorDisplayClusterRemoteControlInterceptor:これを使用すると、nDisplay でレプリケーション可能なすべてのプロパティ値を設定できます。

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル