Web Server DAT

概要

Web Server DATを使用して、WebブラウザなどでWebクライアントとしてTouchDesignerに接続することができます。Web Server DATは、HTTP、WebSocketをサポートしており、画像などのバイナリデータの送受信（アップロード／ダウンロード）も可能です。クライアントのリクエストをどのように処理するかは、コールバックによってユーザーに委ねられています。Web Server DAT は安全で、webserverDAT_Class の authenticateBasic による基本認証もサポートしています。現在のところ、ベーシック認証（エンコードされたユーザ名とパスワード）のみがpythonのメソッドでサポートされています。認証はHTTPリクエスト辞書の’Authorization’というキーで行われます。
最終的には、セキュリティはユーザーの完全な責任となります。ユーザーは、HTTPリクエストが適切に認証されていることを確認し、ユーザー名/パスワードを保存するデータが暗号化されているか、または非公開で保存されていることを確認する必要があります。
HTTPSは、Secure (TLS)パラメーターによってサポートされています。
Web Server DATはPOCO v1.9.1で構築されています。
Web Client DATの章も参照してください。

パラメータ – Web Server ページ
Active / active

ウェブサーバの起動と停止を行います。

Restart / restart

リセットパルスを送信します。

Port / port

Webサーバーの接続ポートを設定します。例：ポート番号が9980の場合、Webサーバーは “localhost:9980 “というアドレスでローカルに（Webブラウザーを介して）接続することができます。

Secure (TLS) / secure

この機能を有効にすると、ウェブサーバーはトランスポートレイヤーセキュリティ（TLS）を使用して、クライアントとの安全な接続を構築します。その結果、WebサーバーはHTTPではなくHTTPSで動作するようになります。

Private Key File Path / privatekey

サーバーのTLS証明書の秘密鍵ファイルのパスを設定します。

Certificate File Path / certificate

サーバーのTLS証明書の証明書ファイルへのパスです。

Callbacks DAT / callbacks

pythonコールバックを持つDATへの参照を設定します。Web Server DAT は Callbacks DAT に大きく依存しており、実際にほとんどの機能がコールバックを経由しています。

onHTTPRequest
WebサーバがHTTPリクエストを受信したときにトリガーされます。リクエストは、HTTPヘッダの辞書です。同様に、レスポンスは、ステータスや理由などのレスポンスデータの辞書です。レスポンス辞書には、HTTPレスポンスのヘッダとして追加されるキー／バリューペアを追加することができます。レスポンスサーバーは、コールバックから返す必要があります。このレスポンスは、クライアントに送り返されます。

onWebSocketOpen
クライアントとのWebSocket接続が開かれたときにトリガされます。クライアントのアドレスがコールバックに渡されます。

onWebSocketClose
WebSocket接続が閉じられたときにトリガーされます。クライアントのアドレスがコールバックに渡されます。

onWebSocketReceiveText
サーバのWebSocket接続がクライアントからテキストデータを受信したときにトリガーされます。テキストデータを送信したクライアントは、コールバックに引き継がれます。

onWebSocketReceiveBinary
サーバのWebSocket接続がクライアントからバイナリデータを受信したときにトリガーされます。バイナリデータを送信したクライアントは、コールバックに引き継がれます。

onServerStart
サーバーの起動時にトリガーされます。

onServerStop
サーバーが停止したときにトリガーされます。

パラメータ – Common ページ

参照：共通 Common ページ