Go to Qiita Advent Calendar 2024 Top
LoginSignup
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Unreal Engine (UE)Advent Calendar 2024

Day 16
@RyogoNagao(長尾 亮虎)

UnrealEngineとPython間でUDP通信する【UE Advent Calendar 2024】

Last updated at Posted at 2024-12-15

目次

はじめに

この記事はUnreal Engine (UE) Advent Calendar 2024の16日目の記事になります！

今回はUnrealEngineとPython間でUDP通信する方法を紹介します！
特に、物理デバイス（自作コントローラー）との連携として使ったので、実装例と共に紹介させていただきます！

実装内容は、同じPC内でPythonとUnrealEngineを連携する方法としてUDPを使っている物になります。
実際に作ると⇩このような形で動きます！

自分で作って思いましたが、めちゃくちゃ反応速度速くてビックリしました。
自作コントローラー作ってる方はぜひやってみてください！

制作背景

実装話の前に、ちょっとだけ制作した背景をまとめます。

今回の実装は 【物理デバイス⇔Python⇔UE】 と言った形で間にPythonを噛ますものになりますが、本来はPythonを使わずとも「プラグインを用いてシリアル通信を使う」などの手法で連携を取ることが出来ます。
こちらの詳細は、昨年記事にしているので、そちらをご確認ください！

ではなぜ、Pythonを使ったのかというと、UE上でシリアル通信のために利用しているプラグインが全ての処理をゲームスレッドで行うために、処理負荷の影響をもろに受け、ゲーム中に処理落ちが多発したためです。

そのため、コントローラー処理を全て外部化すればゲームスレッドに処理負荷の影響を与えない＆疎結合化しやすい！という発想でPythonに手を出した形になります！

実装してみた

では、実装の話に移ろうと思います！
以下の流れで実装していきます。

  1. デバイスの用意
  2. Python実装
  3. UEにプラグインを導入
  4. UE側に処理の記載

UEのプラグイン紹介

今回は「ObjectDeliverer」というプラグインを使ってUDP通信を実装しますので、プロジェクトに追加してください！
記事での実装は【UE4.27】で行っていますが、プラグインはUE5まで対応しているので、同じ実装で問題ないと思います！
※Fabのリンクはこちら

デバイスの用意

今回もM5Stackを事例に実装例を紹介します。
ただし、このデバイスで行っている処理は「シリアル通信でセンサデータをPCに渡す」のみなので、同じ様にシリアル通信で送信できればデバイスはなんでも大丈夫です！

IMUSerial.c
#define M5STACK_MPU6886
#include <M5Stack.h>

float pitch = 0.0F;
float roll  = 0.0F;
float yaw   = 0.0F;

// the setup routine runs once when M5Stack starts up
void setup() {
  M5.begin();
  M5.Power.begin();
  M5.IMU.Init();
}

void loop() {
  M5.IMU.getAhrsData(&pitch, &roll, &yaw);
  
  Serial.print(pitch);
  Serial.print(",");
  Serial.print(roll);
  Serial.print(",");
  Serial.println(yaw);

  M5.update();

  delay(10);
}

Python実装

次に、Pythonの実装になります！
Pythonでは、以下の機能を実装していきます

  • シリアル通信でデバイスからデータの受信
  • UDP通信でUEにデータを送信

事前準備として、シリアル通信用pySerialのライブラリが必要です！
pip install pyserialを実行して、pySerialライブラリをインストールしてください
（Socketは標準で搭載されているので不要です。）

実装手順
準備が出来たらこのようなフローで実装を進めます。

  1. pythonファイルを作成し、コードを添付
  2. デバイスをPCに接続
  3. デバイスマネージャーで接続したデバイスのCOM番号を確認
  4. serial.Serial('COM7', 115200, timeout=1)という部分のCOM7のところを、確認したCOM番号に変更
  5. デバイスが繋がった状態でPythonを実行

実行するとこのような形で、ターミナル上でセンサデータを受け取っているのが確認できます！
実行しているプログラムはCtrl+cキーで停止できます。
image.png

SendData2UE.py
import serial
import socket

ser = serial.Serial('COM7', 115200, timeout=1)

udp_ip = "127.0.0.1"  # Localhost IP (same machine)
udp_port = 1235        # 受信側でも同じポート番号を指定
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)  # UDPsocketを設定

def UdpSender():
    message = "Hello, World!"  # Message to be sent

    try:
        print(f"Message sent: {message}")
    except:
        sock.close()
        print("通信を終了します")

UdpSender()

while True:
    try:
        # シリアル通信からデータを取得
        val_M5 = ser.readline()
        
        # データ解析
        data_str = val_M5.decode('utf-8').strip()
        # print(data_str)
        data_xyz = data_str.split(',')
        print(data_xyz)
        
        x, y, z = map(float, data_xyz)
        print(f"X={x}, Y={y}, Z={z}")
        ValueOnlyMag = f"{x},{y},{z}".encode()
        sock.sendto(ValueOnlyMag, (udp_ip, udp_port))

    # Ctrl+cで停止
    except KeyboardInterrupt:
        print("キーボードによる停止")
        ser.close()
        sock.close()

【コードの中身についてザックリ解説】

シリアル通信部
serial.Serial('COM7', 115200, timeout=1)では、指定したCOM番号のデバイスとシリアル通信をセットアップしており、その後、ser.readline()で送られてきたデータを行ごとに読み出しています。
デバイスからpitch, roll, yawの形でデータが送られてくるので、「,」区切りでデータを分解し、データの送信形式を整えてUDPで送信しています。

UDP通信部
また、今回は同じPC内でUDP通信を行うので、UDP通信で指定するIPアドレスは自分自身を示す「127.0.0.1」のループバックアドレスを指定。
sock.sendto(送信データ, (IPアドレス, ポート番号))にて、指定したIP＆ポートにUDPでデータを送信しています。

UEの実装

最後にUEの実装です！
今回は、ワールド上に設置したCubeをセンサデータで回転させるように実装を行います。

プラグインの使い方は、こちらでも解説されているのでご確認ください！

まずは、レベル上にCubeを追加します。
少し変形さえると回転方向が分かりやすいです！
image.png

次に、レベルブループリントを開いて下図のように実装を行っていきます。
上から順番に紹介します。
image.png

①BeginePlayで実装

今回はテスト実装なので全てBeginePlayにまとめます！
image.png

②接続時の挙動を設定

DelivererManagerクラスを作成し、参照を保持します。このクラスがUDP接続を管理しています。
今回は接続した際に、PrintStringで「接続開始」。接続が切断された場合は「切断」と表示されるようにイベントをバインドしています。
image.png

③受信した際の挙動を設定

UTF-8のString型で受信するDeliveryBoxクラスを作成し、参照を保存します。
このクラスはマネージャークラスから指定したIPアドレスのデータ送受信を受け取る窓口になっています。

Receivedイベントにバインドすることでデータ受信時の挙動を設定できます。
Pythonからはx, y, zの形でデータが送られてくるので、Splitでデータを「,」区切りで分解し、それぞれの回転軸のデータをSetActorRotationでCubeに反映します。
image.png

④UDP通信を開始

必要なセットアップが出来たので、最後にUDP通信を開始します。

CreateProtocolUdpSocketReciverでUDP通信の受信用ソケットを作成します。引数のBoundPortには、Pythonで指定したポート番号（1235）を入れます。
※その他のプロトコル設定はこちら

CreatePacketRuleNodivisionで受信するパケットのルールを設定します。
NoDivisionなので分割無しで生データを受け取る設定になっています。
※その他のルールはこちら

今回は使いませんが、GetIPAddressinStringなどで接続先のIPアドレスの確認が出来ます。

image.png

これで実装は完了です！
あとは、Pythonを実行してから、UEを実行します。
実際の挙動は以下のような形になります！

まとめ

以上になります！
今回の実装は接続と連携のみにフォーカスしてしたため、受信のみの実装ですが、PythonとUEどちらも実装を進めれば、外部デバイスとの連携を外部化してUE側のパフォーマンスに影響を与えないシステムが実装できると思います！

それと今回のPythonコードはほぼChatGPTで生成した物を使っています。
ChatGPTが出力するPythonコードの精度が高く、ほとんど修正無しにPythonを実装出来てめちゃくちゃ便利でした！Python ✖ ChatGPTが便利で良いですねぇ…引き続き使っていきたいと思います！

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?