SpriteStudio edited this page Dec 22, 2017 · 73 revisions

==========================================================

SS5Player for Unreal Engine 4 v1.2.11

Copyright(C) Web Technology Corp. All rights reserved.

==========================================================

概要

OPTPiX SpriteStudio 5 で制作したアニメーションデータを Unreal Engine 4 上で再生するためのプログラムです。
プラグイン形式で提供しています。

SS5Player for Unreal Engine 4は開発を終了しました。

現在開発中のSS6Player for Unreal Engine 4はこちらです。
※SS5Player for Unreal Engine 4の今後のサポート等はUE4のバージョンアップに伴うプラグインのビルド対応を2018/12まで提供する予定です。

対応している Unreal Engine 4 のバージョン

  • ビルド済みプラグインは、Windows版に対応しています。(UE4.15より、Mac版はソースコードのみの提供となりました)
  • プラグイン、ソースコードの対応バージョンについてはREADMEを確認してください。
  • 以前のバージョンに対応したプレイヤーについてはGitHubの過去Tagから取得してください。
  • 基本的に最新バージョンに対応して行きたいと思いますが、Preview版はリリース版での仕様変更が発生する可能性がありますので対応外とさせていただきます。ご了承ください。

(重要)SpriteStudio5.7の対応について

SpriteStudio5.7ではエフェクト機能に再現性の向上や要望の対応のため大幅な変更を行いました。
これによりSpriteStudio5.6.1で作成したエフェクトの挙動がSpriteStudio5.7では変化します。
SS5Player for Unreal Engine 4 v1.2.0ではSpriteStudio5.7のエフェクト機能に対応しています。
プレイヤーのアップデートを行う場合はSpriteStudio5.7にてエフェクトの挙動を確認、調整してください。
SpriteStudio5.6.1のエフェクト機能を使用する場合、プレイヤーのアップデートを行わない事を検討してください。

新機能についてはヒストリア様のv1.2.0紹介記事を参照してください。

SS5Player for Unreal Engine 4 v1.1.xからアップデートを行う場合、エフェクト機能を使用しているアニメーションデータは再インポートが必要です。
再インポートの方法はこちらを参照してください。

チュートリアル

導入手順から、基本的な使い方、まで一通りの情報が下記のリンク先に詳しく書かれています。

ヒストリア様は本プラグインの開発を担当してくださっています。

プラグインの準備

  • シェーダファイルをエンジンのインストールフォルダにコピーします。(UE4.17以前)
    SsPlayerExamples\Plugins\SpriteStudio5\Shaders\に含まれる「SsOffScreenShader.usf」をエンジンのシェーダーフォルダ(例:Unreal Engine 4\Epic Games\バージョン番号\Engine\Shaders\)にコピーします。
    • UE4.17からこの作業は必要なくなりました。

取得する

本プレイヤーのリポジトリをFork、Clone、またはzip形式でダウンロードし、ローカルにコピーしてください。
再生に必要なファイルはすべて Players/Unreal Engine 4 内にまとまっています。
続けて下記の手順に従いプラグインをインストールします。

不具合修正や、新規に実装された機能はまずdevelopブランチにコミットされます。
最新版が必要な場合はdevelopブランチをチェックアウトしてください。

インストールする

はじめに下記の手順でUnrealEngineにプラグインをインストールしておきます。

  1. プロジェクトフォルダ(.uprojectファイルが存在するフォルダ)のPluginsフォルダ以下に、 SpriteStudio5フォルダをコピーします。

  2. プロジェクトを開き、UnrealEngine4の下記のメニューからPluginsウィンドウを開きます。 Window -> Plugins

  3. Pluginsウィンドウの左側のリストから、Installed -> SpriteStudio5 を選択します。

  4. OPTPiX SpriteStudio5 Player for UE4 の「Enabled」チェックボックスをONにします。

Macで使用する場合

C++プロジェクトの場合は、特に追加の手順は必要ありません。 Pluginsフォルダにコピー後に、通常の手順でビルドして下さい。

BPプロジェクトの場合、予めC++プロジェクトに変換しておく必要があります。

C++プロジェクトに変換するには、プロジェクトに空のコードを追加して下さい。 https://docs.unrealengine.com/latest/JPN/Programming/Development/ManagingGameCode/index.html

使い方

インポート設定を確認する

編集>エディタの環境設定でインポート時の挙動を設定する事ができます。

アニメーションをインポートする

アニメーションはsspjファイル単位でインポートします。

  • sspjファイルをContentBrowserにドラッグ&ドロップして下さい。
  • sspjアセットと、必要なテクスチャがロードされます。
  • sspjアセットをダブルクリックすると、ビューアが起動し、内容を確認出来ます。

アニメーションを再生する

Actorから利用する

  • Actorを継承したBluePrintを作成し、Componentに「SsPlayer」を追加します。
  • 追加したSsPlayerの「SsAsset」プロパティに、インポートしたsspjアセットをセットします。
  • 具体的なBluePrintからの使用方法については、サンプルプロジェクトを参照して下さい。

HUDに利用する

  • SsHUDを継承したBluePrintを作成し、GameModeのHUDに登録します。
  • Actorと同様、SsPlayerコンポーネントを追加し、「bDrawMesh」プロパティをオフにします。
  • 具体的なBluePrintからの使用方法については、サンプルプロジェクトを参照して下さい。

サンプルプログラム

  • samples\Unreal Engine 4にアタッチ、コールバック、テクスチャ差し替え、HUD等のサンプルプロジェクトが入っていますので参考にしてください。

ご注意

お問い合わせ

まずこちらのリンクからIssuesページを開き過去に投稿されたFAQをご確認ください。

Issuesページの質問だけ表示する場合はこちら
Issuesページの不具合だけ表示する場合はこちら
Issuesページの要望だけ表示する場合はこちら
同じ内容の質問があった場合、何か追加情報がある場合はコメントに書いて下さい。

質問、不具合、要望を投稿する方法

  • 投稿前に必ずお読みください

    • (重要)投稿した内容について
      投稿した内容は全て一般に公開されますので個人情報や機密情報を記載しないようにご注意ください。
    • 質問をIssueへの書き込むにはGitHubのアカウントが必要です。
      アカウントをお持ちでない場合、こちらのGitHubチュートリアルを参考にアカウントを作成してください。
    • 別のプレイヤー、別のツールの質問はそれぞれのページへ投稿してください。
  • 投稿する
    Title欄に先頭にバージョン番号をvX.X.Xとつけて概要を記入し、Leave a comment に詳細を記入します。
    [Submit new issue] ボタンを押して完了です。後ほど担当者が確認しコメントいたします。

  • 再現データの添付が必要な場合

    • ウェブテクノロジの専用メールアドレス github-spritestudio@webtech.co.jp に添付して送付してください。
  • クリックするとメーラーが起動します。

  • ※送信する前に宛先が上記アドレスと相違ないかご確認ください。

  • ※重要なデータを含んでいる場合は、.zip を暗号化し、パスワードは別途お知らせください。

==========================================================

株式会社ウェブテクノロジ
http://www.webtech.co.jp/
Copyright(C) Web Technology Corp.

==========================================================

  • SpriteStudio, Web Technologyは、株式会社ウェブテクノロジの登録商標です。
  • その他の商品名は各社の登録商標または商標です。
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.