【ベータ機能】CCK・ワールドクラフトで表現をさらにリッチに！「PostProcess API」の紹介

本記事はCluster Creator Kitの「ベータ機能」を利用した解説になります。
ベータ機能では正式リリース前の機能を使うことができます。正式リリース前のため、不安定な挙動をしたり将来的に挙動が変わる可能性があります。また、記事公開時点ではベータ機能として紹介していますが、その後正式リリースされている場合もありますので、本記事を参考にする場合はまずスクリプトレファレンスを参照することをおすすめします。

利用にはCluster Creator Kitでベータ機能を設定した状態でアップロードを行う必要があります。ワールドクラフトで利用する場合は、ワールドクラフトのワールドを新規作成する際にベータ機能の設定を行う必要があります。設定方法はこちらをご覧ください。

Cluster Creator Kitで利用できるベータ機能として、新しく「PostProcess API」の機能が公開されました！
今回は、サンプルコードとこちらの機能で実現できる表現を簡単に紹介します。

Table of Contents

ポストプロセス（PostProcess）とは？

ポストプロセス（PostProcess）は画面全体にフィルターや効果を加えることで、見た目のクオリティを上げることができる機能です。
この機能を使うことで、色収差や魚眼レンズのような表現、ワールドのライトの光の強さを変えたり、色味を変えることができます。

これまでもCluster Creator Kitであれば、Unityの機能を使ってPost Processの実装が可能でしたが、このAPIによりワールドクラフトでもPost Processが可能になりました！

また、プレイヤーごとにポストプロセスがされるため、Cluster Creator Kitでもプレイヤーごとに見える表現を変えたりと工夫した使い方もできそうです。

インタラクトするとポストプロセスが適用されるサンプルコード

下記が適当なオブジェクトにアタッチすることで、インタラクトによってPostProcessを適用できるようにするサンプルです。
「chromaticAberration」の部分を適用したい効果とそこでの設定値に書き換えることで、それぞれの効果が実現できます。

$.onInteract(playerHandle => {
  const effects = new PostProcessEffects();
  effects.chromaticAberration.active = true;
  effects.chromaticAberration.intensity.setValue(1);

  playerHandle.setPostProcessEffects(effects);
});

また、下記のように書き加えることで複数の効果を同時に適用させることができます。

$.onInteract(playerHandle => {
  const effects = new PostProcessEffects();
  effects.chromaticAberration.active = true;
  effects.chromaticAberration.intensity.setValue(1);

  effects.lensDistortion.active = true;
   effects.lensDistortion.intensity.setValue(70);

  playerHandle.setPostProcessEffects(effects);
});

適用したPostProcessを取り消したい場合は、下記のように記述して、別のオブジェクトにアタッチすると、ワールド内でPostProcessを取り消すことができるようになります。

$.onInteract(playerHandle => {
  playerHandle.setPostProcessEffects(null);
});

頻度・距離の制限

ポストプロセスには頻度と距離の制限があります。
詳細はスクリプトレファレンスのこちらのページをご覧ください。

適用の優先順位

PostProcess APIによるポストプロセスは下記の優先度で適用されます。

Creator Kit 製ワールド
- Creator Kit 製ワールドでの Priority が 101 以上のポストプロセス
- setPostProcessEffects によるポストプロセス
- Creator Kit 製ワールドでの Priority が 99 以下のポストプロセス
ワールドクラフト
- 「ワールド環境」の「エフェクト」設定
- setPostProcessEffects によるポストプロセス

その他の詳細な情報はスクリプトリファレンスのこちらの記載を参照してください。