HTTP Sockpuppet
HTTP Sockpuppet を使用すると、HTTP API を介してレイヤーを Sockpuppet 制御できます。このページでは、HTTP Sockpuppet で可能な機能、その制限事項、および Designer でのセットアップ方法の概要を説明します。
レイヤーのパッチ
Section titled “レイヤーのパッチ”HTTP Sockpuppet を介してレイヤーを制御するには、レイヤーをパッチする必要があります。
- タイムライン上のレイヤーを右クリックします。
- Patch to HTTP… をクリックします。
レイヤーが緑色に変わり、レイヤーのすべてのフィールドがパッチされて緑色になります。フィールドがパッチされると、キーフレームで制御できなくなり、HTTP Sockpuppet によってのみ制御されるようになります。
レイヤーのアンパッチ
Section titled “レイヤーのアンパッチ”個々のフィールドは、以下の方法でアンパッチできます。
- レイヤー上のフィールドを右クリックします。
- Toggle Sockpuppet をクリックして、その特定のフィールドをパッチ / アンパッチします。
- Isolate Sockpuppet をクリックして、レイヤー上の他のすべてのフィールドをアンパッチします。
レイヤーの制御
Section titled “レイヤーの制御”パッチされると、レイヤーは /api/session/sockpuppet エンドポイントで制御できます。/api/session/sockpuppet/patches で利用可能なパッチを照会すると、制御可能なパッチと、それぞれで利用可能なフィールドが返されます。その後、api/session/sockpuppet/livechange エンドポイントで値を変更できます。詳細については、API ドキュメントを参照してください。
数値のアニメーション
Section titled “数値のアニメーション”HTTP は値のストリーミングには適していません。DMX over ethernet や OSC のように値のストリームを送信するのではなく、時間の経過とともに値をアニメーション化するためにアニメーションが実装されています。
アニメーションは、パッチ（例: レイヤー）の数値フィールドに適用でき、そのアニメーションはセッション内のすべてのマシンにわたって同期して実行されます。マシンがフレームを落としている場合、同期に問題が見られることがあります。
アニメーションは、開始値、終了値、アニメーションの継続時間、および使用するイージング方式でトリガーされます。開始値がフィールドに設定され、指定されたイージング方式を使用して、継続時間をかけて終了値まで補間されます。補間方式の例には、Linear、Cubic、Quadratic があります。
利用可能なイージング方式は、api/session/sockpuppet/easingfunctions エンドポイントで照会できます。
HTTP Sockpuppet の変更は、変更をセッション全体に配信し、同期した方法で適用できるように、約 2 フレームの遅延を伴って実行されます。
HTTP Sockpuppet を介して値が一度設定されると、d3 が再起動されるまで、常に最後に設定された値（またはアニメーションの最終値）に設定されたままになります。有効期限はありません。
パッチ上のフィールド（例: レイヤー上のフィールド）の現在の値は、api/session/sockpuppet/patches エンドポイントの結果で提供されますが、フィールドのリアルタイム値をストリーミングすることはできません。
HTTP Sockpuppet の変更は、稼働中の Director に送信する必要があります。これはフェイルオーバーの状態によって異なります。