はじめに

「Animated GIF Player」とは

アニメーションGIFプレーヤでは、デスクトップとモバイルでアニメーションGIFを再生できます。

デモムービー - 短いチュートリアル

アニメーションGif Playerコンポーネントをgameオブジェクトに追加し、GIFファイルを選択して、再生を押してください。

主な特徴
スクリプトを必要とせずに使いやすい
-GIFはパフォーマンスを向上させるために別のスレッドでデコードすることができます
- 純粋なC＃のソリューション、余分なプラグインのインストールや編集が不要
コメント付きのソースコードが含まれています
- MovieTextureの代わりとしての短いビデオクリップには便利です
デバイスとウェブの両方からGIFを読み込む

動作環境

Mac 10.13.6
Unity 2018.2.5f1
Animated GIF Player 1.13.4

#使い方
アセットをインポートしてきたら、
gifを貼りたいオブジェクトをシーン上の配置してください
それでAddComponentで「AnimatedGifPlayer」を追加してください
追加で一つ注意としては必ず「RawImage」「MeshRenderer」「SpriteRenderer」コンポネーントのどれか一つ入っているオブジェクトに追加してください
シェーダーは特に差し替えなくても大丈夫です

MeshRendererの場合

次にAnimatedGifPlayerのSelectGIFを押して、Gifを選択します。
Gifの格納場所は必ず「StreamingAssets」フォルダに格納して参照しましょう

あとは再生して上げれば再生されるはずです
ちなみアルファにも対応されています

AnimatedGifPlayerパラメーター

項目	内容
Loop	これをtrueに設定すると、GIFループが作成されます（デフォルト：true）
AutoPlay	初期化時にGIFの再生を開始するには、これをtrueに設定します。
FileName	StreamingAssetsフォルダ内のGIFのファイル名　SelectGifで直接参照できます
ThreadedDecoder	有効にすると、プレーヤーは別のスレッドで各GIFフレームをデコードしますパフォーマンスを向上させます。（デフォルト：有効）
CacheFrames	有効にすると、デコード後に各フレームがメモリにキャッシュされます。デコードはやや遅くなります。これは、GIFをループするときに使用し、デコーダの実行を維持したくない場合に使用します。（デフォルト：無効）
BufferAllFrames	有効にすると、すべてのフレームがロードされ、キャッシュされます GIFプレーヤーが初期化されます。起動は少し遅くなります。なぜなら、再生はすべてのフレームデコードされる。無効にすると、必要に応じて各フレームがデコードされます。（デフォルト：無効）
OverrideTimeScale	Gifの再生速度をTime.timeScaleから独立して設定します
PlaybackSpeed	再生速度

スクリプト制御

アセットに入っているサンプルコードCodeExample.csを解説
初期化で再生したいGifをAnimatedGifPlayerにセットして、Play,Pauseができる簡単なサンプル

CodeExample.cs

using UnityEngine;
using UnityEngine.UI;
using OldMoatGames;

public class CodeExample : MonoBehaviour {
　　　　　　　　//gifプレイヤー
    private AnimatedGifPlayer AnimatedGifPlayer;
    //再生ボタン
    public Button PlayButton;
　　　　　　　//停止ボタン
    public Button PauseButton;

    public void Awake() {
        // AnimatedGifPlayer取得
        AnimatedGifPlayer = GetComponent<AnimatedGifPlayer>();

        // StreamingAssetsフォルダのファイル名指定
        AnimatedGifPlayer.FileName = "AnimatedGIFPlayerExampe 3.gif";

        // 自動再生を無効にする
        AnimatedGifPlayer.AutoPlay = false;

        // GIFが再生準備ができているときに再生を開始する準備完了イベントを追加する
        AnimatedGifPlayer.OnReady += OnGifLoaded;

        // ロードに失敗した場合の準備完了イベントを追加する
        AnimatedGifPlayer.OnLoadError += OnGifLoadError;

        // GIFプレーヤーを初期化する
        AnimatedGifPlayer.Init();

    }

    private void OnGifLoaded() {
        PlayButton.interactable = true;

        Debug.Log("GIF size: width: " + AnimatedGifPlayer.Width + "px, height: " + AnimatedGifPlayer.Height + " px");
    }

    private void OnGifLoadError() {
        Debug.Log("Error Loading GIF");
    }

    //再生
    public void Play() {
        // GIFの再生を開始する
        AnimatedGifPlayer.Play();

        // 再生ボタンを無効にする
        PlayButton.interactable = false;

        // 一時停止ボタンを有効にする
        PauseButton.interactable = true;
    }
　　　　　　　
　　　　　　　　//停止
    public void Pause() {
        // GIFの再生を停止する
        AnimatedGifPlayer.Pause();

        //　再生ボタンを有効にする
        PlayButton.interactable = true;

        // 一時停止ボタンを無効にする
        PauseButton.interactable = false;
    }

    public void OnDisable() {
        AnimatedGifPlayer.OnReady -= Play;
    }
}