Unityのビルドとは？

Unityにおける「ビルド」とは、開発中のゲームプロジェクトを実行可能なアプリケーションやデータに変換する作業のことです。エディタ上で動かしていたゲームを、Windows/Mac用の実行ファイルやWebブラウザで動作するデータ（WebGL）などに出力し、他のユーザーがプレイできる形にします。

Unityエディタでの再生は開発者ローカルのテストに過ぎず、完成したゲームを配布・公開するにはビルドして所定のプラットフォーム用ファイルを用意する必要があります。ビルドを行うことで、初めてUnityをインストールしていないPCでもゲームを起動できたり、Web上に公開して遊んでもらうことが可能になります。

ビルドの結果、例えばWindowsなら「.exe実行ファイルとデータフォルダ」、WebGLなら「index.htmlとUnityの生成したライブラリファイル群」など、プラットフォームごとに必要なファイル一式が出力されます。これらを配布・サーバーアップロードすることでユーザーがゲームをプレイできるようになります。

Unityでゲームをビルドする基本手順

基本的なビルド手順は「シーンの設定 → プラットフォームの選択 → ビルドの実行」という流れになります。

>>公式ページのビルド方法

シーン登録

初めにビルドに含めるシーンを指定します。Unityメニューから File > Build Profiles を開き、Scenes Listに現在のシーンを追加します（「Open Scene List」>「Add Open Scenes」ボタン）。複数シーンがある場合、すべて追加しましょう。

ボタンを押しても何も反応がない場合は、シーンが読み込めていません。
そこで、現在のシーンを変更してから「Add Open Scenes」ボタンを押すと認識できます。

シーンリスト番号「0」が、ゲーム起動時に最初にロードされるシーンになります。一般的にタイトルやメインメニューのシーンを先頭に置きます。ドラッグ＆ドロップで順序を並び替え、一番最初に実行したいシーンがトップに来るよう設定します。

チェックボックスでビルド対象に含めるか除外するかを制御できます。不要なシーンはチェックを外すことでビルドから除外可能ですが、基本的にはリストに追加したシーンはすべて有効にしておきます。Scene移動はスクリプトで制御しないと遷移できないですが、チェックボックスで除外しておく方が無難です。

【Unity】シーン切り替え演出｜フェイドイン・アウト

Unityのシーン切り替え演出の１つにフェイドイン・フェイドアウトがあります。シーン遷移は突然してしまうためフェイドを使い滑らかにすることでユーザビリティ―が向上します。本記事では、ボタンを押してフェイド演出を詳しく解説しています。

alicia-ing.com

2025.04.29

プラットフォームの選択

ビルド設定ウィンドウを開きます（ショートカット: Ctrl+Shift+B）。ここでプロジェクトのビルド対象プラットフォームを設定できます。

左側カラムのPlatformsからビルドしたいターゲットプラットフォームを選びます（ PC向けなら「Windows, MacOS, Linux」、Webブラウザ向けなら「WebGL」、スマホアプリなら「iOS、Android」など）。選択すると右下にビルド対象として表示され、現在のプラットフォームでない場合は「Switch Platform」ボタンが有効になります。

ビルド対象を選んだら、Switch Platformボタンをクリックしてプラットフォームを切り替えます。プラットフォーム切り替え時には必要なライブラリのインポート処理が走るため、完了するまで待ちましょう。切り替え後、選択したプラットフォーム名の右に「(Active)」と表示されます。

ビルドの実行

ビルド前に、必要に応じて右下のDevelopment Build（開発ビルド）やCompression Method（圧縮方式）などのオプションをチェックできます。開発ビルドにチェックを入れるとデバッグ情報付きでビルドされ、パフォーマンスは落ちますがデバッグに有用です。初学者の場合、基本はチェック不要で構いません。

著者の体験談

項目が多すぎるので、基本そのままでOK

ビルドには、Build か Build and Runどちらかを押すと処理されます。「Build」ボタンを押すとビルド処理が始まります（完了後、出力先フォルダを開いて自分で実行ファイルを起動）。「Build and Run」を押すとビルド完了後に自動的にアプリケーション（またはエミュレータ）が起動し、実行結果をすぐ確認できます。開発中はBuild and Runが便利です。

ビルド中はUnityエディタ下部の進行バーに進捗メッセージが表示されます。スクリプトのコンパイルやシーンのデータ書き出しなど、多少時間がかかる場合がありますが完了まで待ちましょう。Consoleウィンドウにエラーが出た場合、ビルドは失敗しています。

ビルドが成功すると、指定したフォルダ内に出力物が生成されます。Windowsは実行ファイル（.exe 等）とDataフォルダ、WebGLの場合はBuildフォルダとindex.html、Androidの場合はAPKファイル等ができています。それらを実行・配置することで実際にゲームが動作するか確認できます。

出品に向けた設定

いざ、ゲームをビルドしてもタイトルがそのままだったり、よくわからないファイルが同封されているなど問題だらけです。また、ゲーム作りはプロでも１年以上は費やして完成をさせます。しかし出品の際に、スクリプトなどを保護をしないと購入者に解析されてしまうことがあります。（逆コンパイル）

このように、個人情報や作品の保護などより質の高いビルドについて解説をします。まずは、Edit >ProjectSettingを開きます（ビルド設定ウィンドウのPlayerSettingからでもOKです。）。

Playerをいじれば基本的なゲーム設定は可能です。「Resolution and Presentation」は画面サイズや比率の設定は後述します。

名前変更

ゲームの主要情報はここで変えることができます。ここはユーザーが見えるところなのでしっかりと変更することが重要です。

• Company Name：会社名（セーブデータ格納とかでフォルダー名になる）
• Product Name：ゲーム名（ゲームファイルの名前になる）
• Verson：バージョン（1.2.3という命名がおすすめ。【ゲーム性】.【機能追加】.【バグ修正】）
• Default Icon：実行ファイルのアイコン。未設定ではUnityのロゴ
• Default Cursor：マウスカーソルの見た目変更。
• Default Hotspot：カーソルの位置、基本的にデフォルトでOK(x,y)=(0,0)

Splash Image（ゲーム開始時の企業ロゴ）

ゲームを開始するときに企業ロゴや注意事項などが出てくる作品がありますが、Unityでも再現ができます。基本初期のままで構いませんが、いくつか変更すると良いところがありますので私が良くする設定で紹介します。

• Splash Screen>Animation：Custom（ロゴのズームをしないように設定）
• Logos>Show Unity Logo：なし（Unityのロゴを非表示。Unity6から無料版でもチェックを外せるように！）

Splash StyleやBackground Colorなどはそれぞれのロゴに適したものを使うと良いでしょう。

Other Settings

その他なのに最も項目が多くてめんどくさいので、変えないといけない箇所だけ紹介します。

• Configuration>Scripting Backend：IL2CPP（スクリプト等の保護。MONOだと逆コンパイルでデータが盗まれる）

その他にも、使っていないスクリプトを削除して軽くする機能もありますが、予期せぬバグになるので省略します。

フォルダーの削除

ビルドを終えると、基本的に削除してはいけないファイルばかりですが、「BurstDebugInformation_DoNotShip」というフォルダーは削除しなければいけません。フォルダーの中身は、ビルド情報が載りますが、よく見ると自分のPC情報が記載されています。

Library: C:\Users\【username】\Desktop\UnityProject\Tile_RPG\Temp\BurstOutput\Data\Plugins\x86_64\lib_burst_generated
–platform=Windows
–backend=burst-llvm-18

Tile_RPG_BurstDebugInformation_DoNotShip/lib_burst_generated.txt

画面サイズと解像度の設定

PC向け（Standalone）ビルドでは、デフォルト設定のままだとゲーム起動時にディスプレイ全画面で表示されます。古いUnityでは起動時に解像度選択ダイアログが表示されることもありましたが、2020年以降のUnityでは初期挙動が自動でフルスクリーンとなる場合が多いです。

必要に応じて、ビルドされたゲームの画面モードや解像度を指定しましょう。

Unityエディタ上部メニューから Edit > Project Settingsを開き、左メニューから Player を選択します。その中の対象プラットフォームのResolution and Presentation セクションを展開してください。ここで画面モードや初期解像度に関する設定を変更できます。

Fullscreen Mode という設定項目があります。デフォルトでは「Fullscreen Window（全画面表示ウィンドウ）」もしくは「Exclusive Fullscreen（専用全画面）」になっています。これを 「Windowed（ウィンドウ表示）」 に変更すると、ビルド後のゲームがウィンドウモードで起動するようになります。フルスクリーンだと起動時にモニタ解像度で全面表示されますが、Windowedにすることでウィンドウ枠のある通常のウィンドウになります。

Default Screen Width（デフォルト幅）、Default Screen Height（デフォルト高さ）という項目で、ウィンドウモード時の初期画面サイズ（解像度）を指定できます。ただしこれらは Fullscreen Modeを「Windowed」にした場合のみ有効です。（フルスクリーン時はモニタ解像度に依存）。例えば幅1920×高さ1080にしたければ、それぞれ1920、1080と設定します。

Resizable Window オプションを true にすると、ユーザーがウィンドウの端をドラッグして自由にリサイズできるようになります。固定サイズで遊ばせたい場合は false に設定し、ウィンドウサイズ変更を禁止します。リサイズを許可する場合、画面比率が変わってUI配置が崩れないようCanvasの設定（UIのScale ModeやReference Resolution）にも注意が必要なので、許可しないことをおすすめします。

著者が実際にしている画面サイズ設定

私の設定では、FullScreenとWindowedモードのハイブリットにしています。

• Fulscreen Mode：Windowed
• Default Screen :幅1280×高さ720

このサイズにしておけば、ほとんどのユーザーのPCに納まるかと思います。

また、以下のスクリプトをゲームのタイトル画面に設置してフルスクリーンとウィンドウどちらにも対応できるようにしています。

    // ウィンドウモードに戻すときのサイズ
    [SerializeField] private int windowWidth = 1280;
    [SerializeField] private int windowHeight = 720;

    // UIボタンから呼ぶ関数
    public void ToggleFullscreen()
    {
        if (Screen.fullScreen)
        {
            // フルスクリーン → ウィンドウモード
            Screen.SetResolution(windowWidth, windowHeight, FullScreenMode.Windowed);
            Debug.Log("Switched to Windowed Mode");
        }
        else
        {
            // ウィンドウモード → フルスクリーン
            Screen.SetResolution(Display.main.systemWidth, Display.main.systemHeight, FullScreenMode.FullScreenWindow);
            Debug.Log("Switched to Fullscreen Mode");
        }
    }

WebGLビルドの方法とポイント

WebGLプラットフォームを選択すると、UnityのゲームをWebブラウザ上で実行できる形でビルドできます。HTML5/WebGL対応ゲームのビルド手順と注意点を解説します。

WebGLでビルドするには、まずUnityにWebGLビルドサポートモジュールがインストールされている必要があります。Unity Hubのインストール項目から現在使用中のUnityバージョンに対し「WebGL Build Support」を追加インストールしてください（未導入の場合、Build SettingsでWebGLプラットフォームを選ぶ際に自動で「Install with Unity Hub」というボタンが表示されます）。

Build Settings ウィンドウで Platform を「WebGL」に選択し、「Switch Platform」で切り替えます。切り替え後、「WebGL」がActiveプラットフォームになったことを確認してください。

WebGLビルド用のPlayer Settingsも確認しておきましょう。たとえば「Publishing Settings」内の Compression Format（圧縮形式）はデフォルトでは Brotli 圧縮が使われます。互換性のためGzip圧縮に変更するケースもあります（Unity公式のUnity Playや一部サーバーではBrotli未対応の場合があるため）。また Memory Size（デフォルト256MB）などWebGL固有の設定項目もありますが、必要に応じて調整します。初回は特に変更せずとも動作しますが、ビルドサイズや読み込み速度の最適化に関わる部分なので、公開時には検討するとよいでしょう。

Build and Run を使うと、ビルド完了後に自動でブラウザが起動しローカルホストでホスティングされたゲームが開きます。Buildのみ実行した場合、出力されたフォルダ（デフォルトでは Build フォルダと Template データ）が生成され、その中のindex.htmlをブラウザで開いても直接は動作しません。WebGLビルドはセキュリティ上、ファイルシステムから直接読み込めないためです。必ずBuild and Runで確認するか、簡易なローカルHTTPサーバーを立ててホスティングしてください。

WebGLのビルド結果として、index.html ファイルと Buildフォルダ（中に .jsonや.wasm、.dataファイルなどが入っています）が生成されます。これら一式をWebサーバー上に配置すれば、ユーザーはブラウザでindex.htmlにアクセスするだけでゲームをプレイできます。UnityRoom（日本国内向けのUnityゲーム投稿サイト）や itch.io, GitHub Pages などにアップロードするのも簡単です。Unity公式の Unity Play や Game Server Hosting なども選択肢になります。

ビルドできない時のトラブルシューティング

ビルド実行中にエラーが発生し「Build failed」となってしまうことがあります。ここでは、「Unityでビルドができない！」となった場合によくある原因と解決策を紹介します。最終的にはエラー文をChatGPTや検索してみるとQiitaやNoteに公開しているユーザーが多いので、これらで解決しましょう。

最初にチェックすべきは、スクリプトのコンパイルエラーです。Unityではスクリプトにエラーがある状態だとビルドは実行できません。エディタ下部のConsoleウィンドウに赤いエラーメッセージが出ていないか確認し、出ている場合は内容に従ってコードを修正してください。典型的には文法ミス（セミコロンの付け忘れ等）や参照切れ、型の不一致などが原因です。コンパイルエラーはビルド以前にエディタ実行中から検知できますので、まずここをゼロにしましょう。

または、ビルド対象プラットフォームのモジュールが入っていない場合、ビルド自体が開始できません（ビルド設定でビルドボタンが押せない状態になる）。例えば「WebGL Module」や「Android Build Support」などがUnityに追加されているかを確認し、入っていなければUnity Hubからインストールします。モジュール不足が原因の場合、エラーメッセージで指摘されることもあります。「Module not loaded」「SDK not found」等のログが出たら該当モジュール/SDKの導入を行ってください。

まとめ

Unityにおけるビルド手順と設定、そしてトラブル発生時の対処法について網羅的に解説しました。

開発途中でもこまめにビルドを行う習慣を付けましょう。Unityエディタ上では正常に動いていても、ビルドすると初めて表面化する不具合は少なくありません。大きな機能追加や変更をした際はその都度ビルドして、予期せぬエラーが出ないか確認することで、後になってエラーの山に悩まされるリスクを減らせます。

バージョン管理とバックアップ: ビルド前後で問題が発生した際に備え、Git等のバージョン管理システムでプロジェクトの変更履歴を残しておくことをお勧めします。特にビルド直前に入れた変更が原因でエラーになった場合、直前のコミットに戻すことで原因の切り分けが容易になります。

ビルドエラーに直面した場合、公式マニュアルのトラブルシューティングやUnityフォーラム、Qiita記事などコミュニティの情報も積極的に参考にしましょう。特にエラーメッセージで検索すると同様のケースに遭遇した開発者の知見が見つかることが多いです。英語で検索するとフォーラムの回答がヒットする場合もあります。

ビルドが無事完了したら、実際に他のPCやデバイスで動作確認をします。画面サイズ設定や挙動が開発機と異ならないか、想定通りフルスクリーン/ウィンドウ表示になるか、WebGLなら複数のブラウザで正常動作するか、といった点をチェックしましょう。問題があれば再度Unity側の設定を調整しビルドし直します。

時間計測を行い、ゲーム終了後にタイマーを停止してシーン切り替えて結果を表示

Unityでゲームを作成する際、時間管理やタイマーの導入はゲームの面白さを左右する重要な要素です。特にアクションゲームやパズルゲームなどでは、時間制限を設けたり、経過時間を計測したりすることでゲームプレイに緊張感や達成感を与えられます。

本記事では、unityで時間管理するメソッドを紹介して、時間計測やタイマーをゲーム内に導入します。

Unityで時間計測とタイマー

Unityでのゲーム開発において、時間計測やタイマー機能は非常に重要な位置を占めます。

ゲーム内で時間制限を明確に設定することにより、プレイヤーに対して緊張感や達成感を生み出し、ゲームのテンポを一定に保つことができるためです。

例えば、クイズゲームでは制限時間を設けることで迅速な判断を促し、制限時間内に答えられなければ不正解とする。カードゲームではプレイヤーが一定時間内に行動をしなければ自動的にターンが次のプレイヤーへと移る仕組みを作ることで、円滑な進行を促します。

【Unity】４択クイズゲームの作り方-アセットなしで作成する

Unityで4択クイズを作成します。ゲーム内では、アニメーションやランダム、BGMを導入して質の高い作品を作ることができます。

alicia-ing.com

2024.10.24

さらに、RPGゲームではクリアタイムを競うタイムアタック要素を設けることで、プレイヤーのモチベーションを維持したり、競争心を高めたりできます。また、時間制限がプレイヤーに明確に示されることで、プレイヤーがより戦略的にゲームを進めたり、瞬時の判断力が求められたりするため、ゲームへの没入感や興奮度を高めることにも繋がります。

こうした様々な側面から、時間管理はゲーム制作において不可欠な要素となっています。

以下で、Unityの時間計測やタイマー機能を実装するために必要な具体的メソッドを詳しく見ていきます。

Time.time

Time.timeはUnityにおける基本的な時間計測メソッドで、ゲームの開始時から現在までの経過時間を秒単位で取得できます。

初心者でも簡単に利用でき、主にシンプルな経過時間表示や簡単なタイマー機能の実装に使えます。

実際のコードでは次のように書きます。

void Update()
{
    float elapsedTime = Time.time;
    Debug.Log("経過時間: " + elapsedTime + "秒");
}

毎フレームごとに経過時間をログに表示しています。素早く実装可能です。

ただし、この方法はあくまでも基本的な時間計測に向いており、細かい制御には不向きな場合があります。

Time.deltaTime

Time.deltaTimeは前フレームからの経過時間を取得する方法であり、特に動きのあるゲームや毎フレーム更新されるタイマーの実装に適しています。

実際のコードでは次のように書きます。

private float timer = 0f;
void Update()
{
    timer += Time.deltaTime;
    Debug.Log("累計時間: " + timer + "秒");
}

このコードはフレームレートに依存しないため、異なる端末や環境でも均一な動きを提供できます。移動速度の制御やアニメーションの時間管理にも非常に有効です。

Time.timeとTime.deltaTimeの違いは？

コード例を見ると、両者に違いがなくTime.timeの方が短く記述できるので、Time.deltaTimeの意味がなさそうに見えるでしょう。

Time.timeはゲーム開始からずっと加算される絶対時間ベースの処理です。タイマー、経過時間判定などに使えますが、リセットをすることができないので色々と不便です。

一方Time.deltaTimeは、前のフレームから今まで何秒経ったか。移動・回転・アニメーションなどをフレーム依存なしで進めることが可能です。

Stopwatch

StopwatchはUnityで高精度の時間計測（ミリ秒単位）が可能なメソッドです。これは主にベンチマークテストや処理の最適化を目的とした精密な処理時間の測定に使われます。

実際のコードでは次のように書きます。

using System.Diagnostics;

Stopwatch stopwatch = new Stopwatch();
stopwatch.Start();
// 計測したい処理
stopwatch.Stop();
Debug.Log("処理時間: " + stopwatch.ElapsedMilliseconds + " ms");

特定処理にかかる正確な時間をミリ秒単位で取得でき、パフォーマンス改善に役立ちます。特徴として、名前空間で「System.Diagnostics」が必要です。

ミリ秒のタイマー

Unityでミリ秒単位の高精度タイマーを導入する場合、Stopwatchが最も推奨されます。
特にリアルタイム性を求めるゲームや、処理精度を要求されるシミュレーションなどで有効です。

Stopwatch timer = new Stopwatch();
timer.Start();
// 時間を測る処理
timer.Stop();
long milliseconds = timer.ElapsedMilliseconds;
Debug.Log("経過時間: " + milliseconds + " ms");

番外編：Coroutine + WaitForSeconds

一定時間後に処理を行う際に役立つのが、CoroutineとWaitForSecondsです。これは遅延処理やクールタイムの実装で頻繁に利用されます。したがって、時間計測には向かないです。例えば、クイズゲームで解答表示3秒後に次の問題を出題するというときに使います。

【Unity】coroutine（コルーチン）で停止や再開を解説

【アセット不要！Unityで作るノベルゲーム】第6回は、Invokeで引数を渡し、数秒後に動作させてオート機能を作ります。オートモードを導入すると、プレイヤーがわざわざクリック操作をせずにストーリーの流れを自動的に楽しむことができます。

alicia-ing.com

2025.08.11

例として、3秒後に特定の処理を行うコードは以下です。

実際のコードでは次のように書きます。

IEnumerator DelayedAction()
{
    yield return new WaitForSeconds(3f);
    Debug.Log("3秒経過しました。");
}

void Start()
{
    StartCoroutine(DelayedAction());
}

このように、指定した時間経過後に処理を自動的に実行できるため、イベント制御やゲームロジックの調整に非常に便利です。

ゲームクリア後、シーン遷移して時間計測結果を表示する

これまでの方法を踏まえて、実際のゲームでクリアタイムを分秒表示し、クリア後はタイマーを停止、シーンを移動して結果を表示する機能を作ります。

シーン移動やドラッグ＆ドロップは別記事で紹介していますので、本記事ではタイマーのみ解説をします。

【Unity】ドラックアンドドロップでゲームオブジェクトを動かす

ゲームオブジェクトをドラッグアンドドロップするには、Camera.main.ScreenToWorldPoint()か、イベントシステムでIPointerDownHandler, IDragHandler, IPointerUpHandlerを使います。

alicia-ing.com

2025.05.03

実装にはTime.deltaTimeを使った簡易タイマーを使います。それぞれのオブジェクトにドラッグ＆ドロップ機能をつけて、クリア時にタイマー停止後シーンを遷移し、結果表示します。

ソースコード1

using UnityEngine;
using TMPro;

public class Timer : MonoBehaviour
{
    [SerializeField] private TMP_Text timerText; // ゲーム中のタイマー表示用
    private float elapsedTime = 0f;
    private bool isRunning = true;

    // クリア時の最終時間を保持する static 変数
    public static float finalTime = 0f;

    void Update()
    {
        if (isRunning)
        {
            elapsedTime += Time.deltaTime;
            int minutes = Mathf.FloorToInt(elapsedTime / 60f);
            int seconds = Mathf.FloorToInt(elapsedTime % 60f);
            timerText.text = string.Format("{0:00}:{1:00}", minutes, seconds);
        }
    }

    // タイマー停止時に最終時間を保存する
    public void StopTimer()
    {
        isRunning = false;
        finalTime = elapsedTime;
    }
}

UdemyでUnityを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

【Unity】学習ロードマップ｜自作ゲームを作りたい人必見！

Unityを使って自作ゲームを作りたい方必見。ゲームエンジン選択から学習方法、収益化の手段まで初心者向けにわかりやすく解説します。

alicia-ing.com

2025.08.11

解説

• 名前空間

「UnityEngine」：Unityの基本機能を利用するために必要。GameObjectやMonoBehaviourクラス、Timeクラスなどが含まれる。
「TMPro」：TextMeshProコンポーネントを使用し、高品質なテキスト表示を実現するために必要。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

• フィールド（メンバ変数）

「timerText」：ゲーム画面に経過時間を表示するTextMeshProコンポーネントへの参照。
「elapsedTime」：ゲーム開始から経過した時間（秒）を保持するための変数。
「isRunning」：タイマーが現在動作中かどうかを示すフラグ（trueで動作中、falseで停止）。
「finalTime」：ゲームクリア時に計測した最終時間を保持するstatic変数。他のクラスからも参照可能。

• Updateメソッド

タイマーが動作中（isRunningがtrue）の場合、経過時間（elapsedTime）に前フレームからの経過時間（Time.deltaTime）を加算する。経過時間を分と秒に分解し、テキスト形式（MM:SS）でtimerTextに表示する処理を行う。

• StopTimerメソッド

タイマーを停止する際に呼ばれ、isRunningフラグをfalseに設定して計測を停止させる。同時に、計測された経過時間をfinalTimeに格納し、クリア時の最終時間として保持する。

実演

タイマースクリプトはゲームマネージャーなど共通管理用オブジェクトにアタッチします。

ゲームを再生すると、冒頭で紹介したような挙動が可能になります。

経過時間を画面上に表示（TMP_Textコンポーネント）ゴールした時点でTimerクラスのStopTimerメソッドを呼び、タイマーを止めます。

まとめ

本記事ではUnityの時間管理やタイマー機能を詳しく解説しました。

Time.time、Time.deltaTimeの基本的な使い方から、Stopwatchを利用した高精度タイマー、Coroutineを利用した時間制御の方法まで、幅広くカバーしました。

これらの技術を活用し、より質の高い、魅力的なゲームを作りましょう。

TextMeshProでテキストを一文字ずつ、文字送りする。

Unityでノベルゲームのような会話シーンを制作するとき、「文字を1文字ずつ表示したい！」ことがあると思います。

突然テキストが表示されるのではなく、まるでキャラクターが実際に話しているかのような演出があれば、プレイヤーの没入感も大きくアップさせることができます。

しかし、「実際にどうやって実装するの？」や「初心者でも簡単にできる方法はないの？」と悩んでいる方も多いでしょう。

本記事では、UnityのTextMeshPro（TMP）を使って1文字ずつ表示する方法を分かりやすく解説します。

具体的な実装例や注意点も挙げながら、初心者の方でも迷わず実践できる内容にしています。

文字送り表示

文字送りとは、テキストが一瞬で表示されるのではなく、1文字ずつ流れるように表示されるアニメーションのことを指します。

これはノベルゲームやアドベンチャーゲームなど、キャラクター同士が会話をするシーンでよく用いられています。

1文字ずつ表示されることによって、キャラクターが実際に言葉を話しているかのような臨場感を出すことができます。

プレイヤーの没入感を高める重要な要素なので、ゲームのクオリティを上げたいならぜひマスターしましょう。

また、RPGやチュートリアル表示など、幅広いジャンルのゲームにも応用可能です。

コルーチンで実装

Unityで1文字ずつの表示を効率的かつ簡単に実現するためには、
「コルーチン（Coroutine）」を使用します。

コルーチンとは、特定の処理を途中で待機（一定時間停止）させたり、
少しずつ処理を実行したりできるUnity特有の便利な機能です。

【Unity】coroutine（コルーチン）で停止や再開を解説

【アセット不要！Unityで作るノベルゲーム】第6回は、Invokeで引数を渡し、数秒後に動作させてオート機能を作ります。オートモードを導入すると、プレイヤーがわざわざクリック操作をせずにストーリーの流れを自動的に楽しむことができます。

alicia-ing.com

2025.08.11

似た機能にInvokeというものがありますが、Invokeは指定した関数を一度または定期的に呼び出すシンプルな仕組みであるのに対し、コルーチンは細かな処理の制御に適しています。

本記事のような単純に文字送りをするだけならInvokeでも良いですが、
文字送りの速度を微調整したり、特定の文字だけ遅らせたりする場合は、コルーチンをおすすめします。

【Unity】Invokeで引数を渡す、途中で停止・中断。

UnityのInvokeを使って引数を渡す方法や、処理を途中で停止するテクニックを解説。また、コールチンとの違いを紹介。

alicia-ing.com

2025.05.18

コルーチンを使った1文字ずつ表示する

今回紹介する方法は、TextMeshPro（テキストメッシュプロ）を使って、
簡単に実装できるシンプルな方法です。

ソースコードの大まかな流れは以下の通りです。

Unityでテキストを表示するのは多種ありますが、TextMeshProが主流です。
制御もしやすく、フォントを自由に使うことができます。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

stringを使用してスクリプト内のテキストで表示させる方法もありますが、
本記事では扱いやすくてより実践的なCSVファイルを読み込んで表示します。

【Unity】CSVファイルを読み込み、テキストを画面に表示する

UnityでのCSVファイルの読み込み方法を解説します。エクセルやGoogleスプレッドシートでcsvを作成し、データのインポート・読み書き・外部ファイル読み込みを簡単に実装する方法を紹介。

alicia-ing.com

2025.08.12

ソースコード

using System.Collections;
using UnityEngine;
using TMPro;
using System.IO;

public class typing : MonoBehaviour
{
    public TextMeshProUGUI LogText;
    public float typingInterval = 0.05f; // 文字表示の速度

    private string fullText;
    private bool isTyping = false;//タイピング開始

    void Start()
    {
        LoadCSV("Sample");
    }

    void LoadCSV(string fileName)
    {
        TextAsset csvFile = Resources.Load<TextAsset>(fileName);
        if (csvFile != null)
        {
            using (StringReader reader = new StringReader(csvFile.text))
            {
                fullText = reader.ReadLine();
            }
            StartCoroutine(TypeText());
        }
        else
        {
            Debug.LogError($"CSVファイル({fileName})が見つかりません。");
        }
    }

    IEnumerator TypeText()
    {
        isTyping = true;
        LogText.text = "";
        int i = 0;

        while (i < fullText.Length)
        {
            if (fullText[i] == '<') // タグ開始の処理
            {
                int tagEnd = fullText.IndexOf('>', i);
                if (tagEnd != -1)
                {
                    LogText.text += fullText.Substring(i, tagEnd - i + 1);
                    i = tagEnd + 1;
                }
            }
            else
            {
                LogText.text += fullText[i];
                i++;
                yield return new WaitForSeconds(typingInterval);
            }
        }

        isTyping = false;
    }
}

UdemyでUnityを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

【Unity】学習ロードマップ｜自作ゲームを作りたい人必見！

Unityを使って自作ゲームを作りたい方必見。ゲームエンジン選択から学習方法、収益化の手段まで初心者向けにわかりやすく解説します。

alicia-ing.com

2025.08.11

解説

• 名前空間

「System.Collections」：IEnumeratorとコルーチンを利用するために必要。
「UnityEngine」：MonoBehaviourを継承し、Unityの基本機能を使用するために必要。
「TMPro」：TextMeshProUGUIを使用し、UIにテキスト表示を行うために必要。
「System.IO」：文字列の読み込みや操作にStringReaderを使用するために必要。

• フィールド（メンバ変数）

「LogText」：画面に表示するテキスト（TMP）を格納し、逐次テキストを追加表示するためのUI要素。
「typingInterval」：1文字表示ごとの待機時間（秒数）を指定することで、テキスト表示の速度を調整する。
「fullText」：CSVファイルから読み込んだ表示対象の文字列を格納する。
「isTyping」：現在タイピング表示処理が進行中か否かを判定するフラグ（真偽値）。

• LoadCSVメソッド

引数として渡されたファイル名（Resources内にあるCSV形式のテキストファイル）を読み込む。

読み込みが成功すると、ファイルから取得した最初の行のテキストをfullTextに格納し、
TypeTextコルーチンを呼び出して文字列の逐次表示を開始する。

指定のファイルが存在しない場合は、エラーをログに表示する。

• TypeTextメソッド

コルーチンを用いて、fullTextに格納されているテキストを1文字ずつ表示する。

文字列内にHTMLタグなどの特殊タグ（<…>）があった場合はタグ全体をまとめて表示し、
タグが途切れないよう処理する。

タグではない通常の文字は、指定したインターバル（typingInterval）ごとに1文字ずつ追加表示される。

全ての文字を表示し終えると、isTypingフラグをfalseに戻し、処理を完了する。

実演

作成したスクリプトをInspectorウィンドウにアタッチして実行すると、
以下のような挙動を確認できます。

CSVはResourcesフォルダーに入れて管理しますが、現在は非推奨です。

【Unity】Resourcesフォルダの使い方と非推奨な理由

UnityのResourcesフォルダは、アセットを動的に管理できる機能ですが、非推奨とされる。ビルドサイズの増加やメモリ管理の難しさ、アセット参照の追跡が困難になることなどで、「アドレッサブルシステム」を利用することが推奨とされる。

alicia-ing.com

2025.04.29

文字送り中に、右クリックで全表示する

さらに快適なユーザー体験を提供するために、応用機能として「右クリックすると瞬時に全テキストが表示される機能」も追加してみましょう。

これによりプレイヤーが待ち時間を自由にコントロールでき、ストレスを軽減できます。

void Update()
{
    if (Input.GetMouseButtonDown(1) && isTyping)
    {
        StopAllCoroutines();
        LogText.text = fullText;
        isTyping = false;
    }
}

右クリックでコルーチンを途中停止することで、処理の完了を即時化します。

まとめ

この記事では、UnityのTextMeshProを使った1文字ずつ表示する方法を解説しました。

キャラクターが実際に会話しているような演出を実現することで、
ゲームのクオリティやプレイヤーの没入感が大幅に向上します。

また、「右クリック即時表示」機能を導入すれば、
ユーザーがさらに快適にゲームを楽しめます。

次のステップとして以下の記事もチェックして、さらなるスキルアップを目指しましょう！

音程を高くすることなく、再生速度だけ変える。

Unityでゲームやアプリケーションを制作する際、
音声の再生速度を変更することは演出や操作感の向上に非常に有効です。

しかし、再生速度を単純に上げると、音の高さも一緒に上がってしまい、
思い通りのサウンドにならないケースが多々あります。

本記事では、AudioSourceのピッチ設定を利用しつつ、
AudioMixerのPitch Shifterを併用することで、再生速度だけを変更し、
音程はそのまま維持する方法について詳しく説明します。

Pitch（AudioSource）

AudioSourceのピッチ（Pitch）は、音声の再生速度と周波数を決定する重要なパラメータです。

ピッチの値を上げると再生速度が速くなり、同時に音の高さ（周波数）も上昇します。
ピッチを上げるとこのサンプルレートが相対的に高くなり、
波形の周期が短縮されることで音程が上昇します。

たとえば、以下のようにピッチを1.5に設定すると、
元の再生速度よりも50％速く再生され、音程も高く聞こえるようになります。

ピッチの変更は、InspectorウィンドウのAudioSourceで操作できますが、
スクリプトを使うことでも制御可能です。

// AudioSourceのピッチを1.5に変更する例
audioSource.pitch = 1.5f;

PitchShifter

PitchShifterは、AudioMixer上で動作するオーディオエフェクトの一種です。
このエフェクトは、再生速度を変更した際に生じる音程の変化を補正するために利用されます。

音の高さを変えないためには、AudioSourceのピッチ操作によって速くなった再生速度に合わせ、
逆数の値を用いてPitch Shifterを調整することで、音程を元の状態に近づけることが可能となります。

AudioSourceのピッチ操作と同様にInspectorウィンドウからだけではなく、
スクリプト制御が可能です。

// AudioMixerのPitch Shifterパラメータを設定する例（パラメータ名："PitchShifter"）
audioMixer.SetFloat("PitchShifter", 0.75f);

PitchShifterの作成方法

PitchShifterを利用するためには、Unityエディタ内でAudioMixerを正しく設定し、
Pitch Shifterエフェクトを適用する必要があります。

作成したAudioMixerをダブルクリック、あるいはUnityエディタ上部のメニューから「Window」＞「AudioMixer」を選択し、新規または既存のAudioMixerを開きます。

AudioMixerは複数のオーディオグループをまとめて管理できるため、
エフェクトの適用や音量調整が容易になります。

作成したAudioMixer内の適用対象となるミキサーグループを選択します。
本記事では、「Master」を使用します。
「Add…」ボタンをクリックし、リストから「Pitch Shifter」エフェクトを追加します。

Pitch Shifterエフェクトは、AudioSourceのピッチ変更に伴う音程のズレを補正する機能です。

エフェクトパラメータのExpose

Pitch Shifterエフェクトを導入して、ゲームを再生すると警告文が出てきます。

警告文の内容は、PitchShifterがないというもの。

Exposed name does not exist: PitchShifter
UnityEngine.StackTraceUtility:ExtractStackTrace ()

エフェクト追加後、Pitch Shifterのパラメータをスクリプトから操作できるようにExposeします。

InspectorウインドウのPitch Shifterエフェクトでパラメータ名を右クリックします。

「Expose pitch to script」でスクリプト制御を可能にします。
さらに、「Exposed Parameters」で名前を「PitchShifter」に変更します。

この設定でスクリプト側からAudioMixer.SetFloat(“PitchShifter”, 補正値)を利用して、
エフェクトのパラメータにアクセス可能となります。

再生速度だけ上げて高さはそのまま

再生速度だけを上げて音程（高さ）は変えないように、
AudioSourceとAudioMixerの両方を連動させる設定を行ってきました。

そこで、スライダーを操作して再生速度だけ上げる機能を作成します。

【Unity】スライダー使い方｜制限時間ゲージ、HPバー、音量調整

Unityでスライダー（Slider）の使い方を解説。実用例として制限時間ゲージやHPバー・体力ゲージ、音量調整をスクリプトで紹介します。sliderを離したとき・押したときの処理やデザインの変更を紹介します。

alicia-ing.com

2025.05.03

方法はAudioSourceのpitchプロパティを変更して、再生速度を調整する。
同時に、AudioMixer上のPitchShifterパラメータに、AudioSourceのpitch値の逆数を設定する。

【Unity】csvファイルから画像と音声をパスで読み込み

resourcesフォルダーは、Unityで画像や音声、プレハブ、csvを扱う際に便利な機能ですが、メモリの負担が多大きく非推奨な機能です。しかし、規模によっては使用に問題はありません。

alicia-ing.com

2025.08.11

ソースコード

using UnityEngine;
using UnityEngine.UI;
using TMPro;
using UnityEngine.Audio;

public class AudioPitchController : MonoBehaviour
{
    public AudioSource audioSource;  // 操作対象の AudioSource
    public Slider pitchSlider;       // スライダー
    public TMP_Text pitchText;       // 再生速度表示用の TMP
    public AudioMixer audioMixer;    // AudioMixer（Pitch Shifterを制御するため）

    private const string PitchShifterParam = "PitchShifter"; // Audio Mixer の Pitch パラメータ

    void Start()
    {
        if (pitchSlider != null)
        {
            pitchSlider.minValue = 0.5f; // スライダーの最小値を0.5
            pitchSlider.maxValue = 2.0f; // スライダーの最大値を2.0
            pitchSlider.value = 1.0f;    // 初期値を1.0
            pitchSlider.onValueChanged.AddListener(UpdatePitch);
        }

        UpdatePitch(pitchSlider.value); // 初期値の設定
    }

    void UpdatePitch(float value)
    {
        // AudioSource の pitch を変更
        if (audioSource != null)
        {
            audioSource.pitch = value; // 再生速度変更
            Debug.Log($"AudioSource.pitch = {audioSource.pitch}");
        }
        else
        {
            Debug.LogWarning("AudioSource が設定されていません！");
        }

        // AudioMixer の Pitch Shifter を調整
        if (audioMixer != null)
        {
            float pitchShifterValue = 1.0f / value; // 逆数にすることで音程を一定に保つ
            audioMixer.SetFloat(PitchShifterParam, pitchShifterValue);
            Debug.Log($"AudioMixer Pitch Shifter = {pitchShifterValue}");
        }
        else
        {
            Debug.LogWarning("AudioMixer が設定されていません！");
        }

        // Text 表示を更新
        if (pitchText != null)
        {
            pitchText.text = $"×{value:F2}"; // 小数2桁で表示
        }
    }
}

UdemyでUnityを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

【Unity】学習ロードマップ｜自作ゲームを作りたい人必見！

Unityを使って自作ゲームを作りたい方必見。ゲームエンジン選択から学習方法、収益化の手段まで初心者向けにわかりやすく解説します。

alicia-ing.com

2025.08.11

解説

• 名前空間

UnityEngine：ゲーム開発の基本機能（GameObject、Transform、MonoBehaviourなど）を利用するために必要です。
UnityEngine.UI：UIコンポーネント（スライダーなど）を利用するために必要です。
TMPro：TextMeshProのテキスト表示機能を利用するために必要です。
UnityEngine.Audio：オーディオの再生やミキシング、AudioMixerを操作するために必要です。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

• フィールド（メンバ変数）

audioSource：音声再生の制御を担うAudioSourceコンポーネントを参照します。
pitchSlider：再生速度（ピッチ）の調整に使用するスライダーコンポーネントを参照します。
pitchText：現在の再生速度をテキスト表示するためのTextMeshProコンポーネントを参照します。
audioMixer：ピッチシフターのパラメータを調整するためのAudioMixerコンポーネントを参照します。
PitchShifterParam：AudioMixer内のピッチシフターを制御するためのパラメータ名「PitchShifter」を保持する定数です。

• Startメソッド

スライダーが存在する場合、最小値（0.5）、最大値（2.0）、初期値（1.0）を設定し、
スライダー値の変化でUpdatePitchメソッドが呼ばれるようリスナーを登録します。

その後、初期値をもとに一度UpdatePitchメソッドを実行し、
AudioSourceやAudioMixer、テキスト表示などの初期状態を反映させます。

• UpdatePitchメソッド

AudioSourceが設定されていれば、そのpitchプロパティを更新し、再生速度を変更します。
設定されていない場合は警告ログを出力します。

AudioMixerが設定されていれば、引数の逆数を計算してピッチシフターのパラメータを調整し、音程を一定に保つよう補正します。

設定されていない場合は警告ログを出力します。
TMPテキストが設定されていれば、計算された再生速度を小数点以下2桁でフォーマットし、
テキストに反映させます。

【Unity】カウントアップでリザルト画面にスコアを表示

Unityでスコアを表示します。カウントアップ機能や別シーンに移動してリザルト画面を表示など紹介しています。

alicia-ing.com

2025.04.16

実演

初めに、シーン内に必要なUIコンポーネントを正しくアタッチしてください。

シーンが開始されると、スクリプトのStartメソッドが実行され、
まずUI（特にSlider）の初期設定が行われます。

スライダーの最小値（0.5）、最大値（2.0）、初期値（1.0）が設定され、
値が変更されるたびにUpdatePitchメソッドが呼ばれるようリスナーが登録されます。

スライダーの値が直接AudioSourceのpitchプロパティに反映され、再生速度が変わります。

音の高さが変わらないようにするため、AudioMixerのPitch Shifterパラメータには、
スライダーの値の逆数が適用されます。

まとめ

本記事では、UnityにおけるAudioSourceのピッチ操作とAudioMixerのPitch Shifterエフェクトを組み合わせ、再生速度のみを変更しながらも音程を維持する方法について解説しました。

この技法は、ゲーム内のBGM、効果音、ナレーションなど、さまざまなシーンで応用可能です。
例えば、スローや早送りの演出、ユーザーの操作に応じたリアルタイムな音声変化など、音響面での表現の幅を大きく広げることができます。

スクロールビューの使い方をマスターできる。

Unityのスクロールビュー（ScrollView）は、UI要素をスクロール可能にする便利な機能です。

特に、ゲームやアプリのメニュー画面、ランキング表示、チャットウィンドウなどでよく使われます。

しかし、「スクロールビューの使い方が分からない」・「要素を等間隔にレイアウトしたい」と悩む人も多いでしょう。

本記事では、Unityのスクロールビューの基本的な使い方、要素を適切に配置する方法、スクロールの遅延や重さの解決策について詳細に解説します。

また、自動スクロールの実装、パフォーマンスを最適化するテクニックも紹介します。

スクロールビュー（ScrollView）

ScrollViewは、コンテンツが画面サイズを超える場合に、
スクロール可能な領域を提供するUIコンポーネントです。

主に以下のような場面で活用されます。

UIの中にスライダーがあります。
スライダーはゲージとなる一方で、スクロールビューは一覧を表示します。

【Unity】スライダー使い方｜制限時間ゲージ、HPバー、音量調整

Unityでスライダー（Slider）の使い方を解説。実用例として制限時間ゲージやHPバー・体力ゲージ、音量調整をスクリプトで紹介します。sliderを離したとき・押したときの処理やデザインの変更を紹介します。

alicia-ing.com

2025.05.03

スクロールビューの使い方

スクロールビューは、Hierarchyウィンドウの「UI」から「Scroll View」で追加します。

作成したスクロールビューが小さいので、画面にサイズが合うようにします。
自分でWidthとHeightを調整してもよいですが、「Anchor Presets」でサイズ変更もできます。

「Altキー」を押しながら、縦（高さ）を画面に自動調整を指示します。

【Unity】画面サイズの変更、合わせる設定とおすすめの比率

Unityで画面サイズのおすすめとUI設置を最適化する方法を解説。各プラットフォームやノベルゲーム、パズルゲーム、RPGなど各ゲームに合わせた画面比率で画面のサイズを変えて、さらに動的なUI操作のヒントを提供します。

alicia-ing.com

2025.05.03

Layout Group

スクロールビュー内に画像UIのようなコンテンツを入れるには、
Viewportの配下「Content」の子要素にする必要があります。

しかし、ただ要素を入れるだけではオブジェクトが重なってしまう問題が発生します。

そこで、「Layout Group」のcomponentを使用して要素を配置します。

縦方向のスクロールではマウスのスクロールと対応しやすいので、
ユーザーがストレスなく操作しやすくなります。

スクロールできない

Layout Groupを設定し、配列を整えました。
しかし、スクロールバーが消えて、下まで進めてもコンテンツが元に戻ってしまう。

原因は、「Content」の大きさが適切ではないということです。
決まった情報をプレイヤーに提供するならばはじめからサイズ指定が有効ですが、
プレイヤーの行動によって情報量が増えるならば大きさを指定することは難しいです。

スクロールバーをコンテンツに応じて変えるときは、
componentから「Content Size Fitter」を追加します。

Content Size Fitterは、UI 要素（RectTransform）のサイズをその内容に応じて自動調整するための Layout Component です。

今回のようにScrollViewのContentに適用して、子要素に応じたサイズ変更を行うのに使われます。
特に、Layout Groupと併用すると効果的です。

スクロールが重い

初期のスクロールビューでは、スクロールしてもコンテンツが全く動きません。

要素が多すぎて動きが重いということもありますが、
基本的には「Scroll Sensitivity」で解決できます。

まとめ

また、ユーザーの操作なしにスクロールを自動で行う場合、以下のように Lerp を活用できます。

void Update()
{
    scrollRect.verticalNormalizedPosition = Mathf.Lerp(scrollRect.verticalNormalizedPosition, 0, Time.deltaTime * 0.5f);
}

Pythonで進捗バーを表示する。

Pythonで処理する際に、どれだけ処理が完了したのかコンソール画面に表示します。
進捗バー（プログレスバー）を作成したい方に向けて、tqdmを使用した進捗表示の方法を解説します。

本記事では、tqdmの基本の使い方や実際のソースコードを例示し、
処理の進捗をわかりやすく表示する方法を紹介します。

tqdmとは

モジュールtqdmは、処理の進捗を視覚的に表示するための便利なライブラリです。

大量のデータや複数の処理を行う際、その進捗を表示することで、
開発者やユーザーに安心感を提供します。

進捗表示を使うことで、大規模なプロジェクトや複雑なタスクでも、
現在どの程度進行しているのかを一目で把握できるようになります。

例えば、データ処理の際にも、どれくらいの作業が完了したか、
予定に対してどれだけ進んでいるのかを視覚化することが可能です。

tqdmをインストールするには、pipを使用します。

pip install tqdm

基本的な機能

基本的な使い方としては、forループにtqdmを追加するだけで、
簡単に進捗バーを表示することができます。

tqdmは、処理の進行状況を正確に視覚化するだけでなく、
プログラムのパフォーマンスにほとんど負担をかけずに自然に表示できるので、非常に便利です。

また、進捗をリアルタイムで確認できるため、
長時間の処理でもユーザーに安心感を与えることができます。

from tqdm import tqdm
import time

for i in tqdm(range(10), desc="Processing"):
    time.sleep(0.5)  # 一時停止を作る

このコードでは、10回のループを繰り返している間に進捗バーが表示されます。

【Python】カウントダウンタイマー｜sleepでタイマー処理

Pythonでのタイマーとカウントダウンの作り方は、tkinterを使用してsleep関数とtimerを組み合わせ、使いやすいタイマーを実装できます。

alicia-ing.com

2025.08.11

descを使って処理内容を説明することで、
何をしているのかをユーザーにわかりやすく伝えることができます。

これにより、ユーザーにも進行状況が伝わり、処理が進んでいる感覚を共有できます。

すべての処理の完了率をゲージで表示

指定されたフォルダ内の画像ファイルをWebP形式に変換する処理を実行します。

処理は、フォルダ内のファイルを順次ループし、
PillowライブラリのImage関数を使って画像をWebP形式に変換します。

【Python】pngやjpgの画像をwebpに一括で画像変換

pngやjpeg、bmpを画像変換するためにフリーソフトを探しても求めるものがないときはPythonのpillow,osモジュールで一括でwebpにします。自作ならwindows、macの対応を気にせず、応用でheicやavifもできます。

alicia-ing.com

2025.08.11

その際、tqdmを用いて進捗状況を一歩ずつ表示し、処理の完了までの時間を視覚化しています。

これにより、処理がどの程度進んでいるかを簡単に把握することができ、
使用者や開発者が実行時間を予測したり、処理の進行を確認することが可能です。

また、処理中にエラーが発生した場合、どのファイルで問題が発生したのかを明確に特定できるため、トラブルシューティングも容易です。

ソースコード・解説

• モジュール名

「PIL (Pillow)」：Python Imaging Library（PIL）を拡張したPillowモジュールは、画像ファイルの読み込みや保存、編集を行うために必要です。インストールは「pip install Pillow」を使用します。
「os」：ファイルやディレクトリのパス操作を行うために必要です。特にフォルダの存在確認やファイルのパス取得に使用します。
「tqdm」：長時間実行する処理の進捗状況を視覚的に表示するために必要です。インストールは「pip install tqdm」を使用します。
「time」：処理に微小な遅延を持たせるために必要です。これにより進捗バーが滑らかに動くように見せる効果があります。

from PIL import Image
import os
from tqdm import tqdm
import time

• フィールド（メンバ変数）

「input_folder」：変換対象となる画像ファイルが格納されているフォルダのパスです。
「output_folder」：変換後の画像ファイルを保存するためのフォルダのパスです。
「file_list」：入力フォルダ内の変換対象画像ファイルのリストです。
「progress_bar」：tqdmによって生成される進捗バーオブジェクトで、処理の進捗を視覚的に表示するためのものです。
「input_path」：入力画像ファイルの絶対パスです。
「output_path」：変換後のWebP形式の画像ファイルの絶対パスです。

• convert_to_webp関数

この関数は、指定されたフォルダ内の画像ファイルをWebP形式に変換する処理を行います。

最初に出力フォルダが存在しない場合は新たに作成し、
入力フォルダ内の画像ファイルを拡張子でフィルタリングして取得します。

取得したファイルリストを使って、一つずつ画像ファイルを開き、
WebP形式に変換して出力フォルダに保存します。

処理の進捗状況はtqdmで表示し、
全てのファイルが処理されるとメッセージを表示します。

def convert_to_webp(input_folder, output_folder):
    # 出力フォルダが存在しない場合は作成する
    if not os.path.exists(output_folder):
        os.makedirs(output_folder)

    # フォルダ内のファイルを取得する
    file_list = [f for f in os.listdir(input_folder) if f.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.bmp'))]

    # ファイル数が0の場合、処理を終了
    if not file_list:
        print("画像ファイルが見つかりませんでした。")
        return

    # tqdmで進捗バーを作成
    progress_bar = tqdm(total=len(file_list), desc="変換中", unit="file", smoothing=0.1)

    for file_name in file_list:
        # ファイルの絶対パスを取得する
        input_path = os.path.join(input_folder, file_name)
        output_path = os.path.join(output_folder, os.path.splitext(file_name)[0] + '.webp')

        # 画像を開いてWebP形式で保存する
        try:
            with Image.open(input_path) as image:
                image.save(output_path, 'webp')
        except Exception as e:
            print(f"エラー: {file_name} ({e})")

        # 進捗バーを更新
        progress_bar.update(1)
        time.sleep(0.01)  # 流れる感覚を持たせるための微小な遅延

    progress_bar.close()
    print("全ての画像の変換が完了しました！")

# フォルダのパスを指定して変換を実行する
input_folder = 'Input'
output_folder = 'Output'

convert_to_webp(input_folder, output_folder)

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

実演

プログラムを実行すると、冒頭で示したような進捗バーが表示されます。

本記事での例では、画像変換なのであまり進捗バーの役割を成さないですが、
動画や人工知能などの大きいデータを扱う場合は進捗バーがあるとプログラムが動いているのか把握できます。

必要に応じて、プログレスバーを導入してください。

まとめ

本記事では、Pythonで進捗バーを作成するためのライブラリ、tqdmの使い方を解説しました。

既存のスクリプトにtqdmを実装することで、処理の進捗を視覚的に確認しながら、
効率的に作業を進めることが可能になります。

tqdmを使うことで、従来の処理に比べてよりユーザーフレンドリーな体験を提供し、
開発者は実行中の処理を可視化しやすくなり、デバッグや評価時の助けにもなります。

次回の開発では、さらに複雑な処理にもこの進捗表示を実装して、便利さを向上させていきましょう。

Google Text-to-SpeechをPythonから制御する。

GoogleのText-to-Speech APIを使えば、
Pythonを用いて簡単にテキストを音声に変換できます。

本記事では初めての方にも分かりやすく、
APIの取得方法からPythonでの実装までを詳しく解説していきます。

また、商用利用や料金、音声ファイルの保存方法など、
Pythonで自動音声生成を行う手順を完全に理解できる内容となっています。

Google Text-to-Speechとは

Google Text-to-Speechはテキストを音声に変換するサービスで、
無料で使える発話エンジンです。

日本語、英語、フランス語など、多くの言語に対応していて幅広い用途で利用できます。

Pythonと組み合わせることで、さまざまな音声アプリケーションを簡単に作成できます。
たとえば、ナビゲーションシステムや教育アプリ、自動応答システムなど用途は無限大です。

Google Text-to-SpeechはAI技術を駆使して、自然で高品質な音声を生成します。
これにより、ユーザーにとって使いやすく、聞き心地の良い音声を提供することが可能です。

また、Text-to-Speechはアクセントや話者のトーンなども調整可能なため、
さまざまな音声タイプをカスタマイズできます。

Google Text-to-Speechの使い方

Google Text-to-Speechを使うには、まずGoogle Cloudのアカウントを作成し、
Text-to-Speechを有効にする必要があります。

Pythonのプログラムから音声合成を行うためには、
Google Cloudの認証情報（APIキー）を取得して設定する必要があります。

Pythonコードを用いることで、指定したテキストを音声に変換し、
WAVやMP3形式で保存することが可能です。

これにより、手軽に音声ガイドやナレーションを自動生成することができます。
例えば、観光案内アプリでの音声案内や教育用の教材など、多種多様な用途で活用できます。

また、テキストの内容に基づいて発話速度やピッチも調整できるため、
さまざまなシチュエーションに対応した音声を生成することが可能です。

Google Text-to-Speechは商用利用できる？

Google Text-to-Speechは商用利用も可能です。
ただし、Google Cloudの使用量に応じた料金が発生するため、
商用プロジェクトで利用する際は料金体系に十分注意する必要があります。

また、Googleの利用規約に従って、適切に利用することが求められます。

商用利用する場合、特に注意すべきなのは利用料金と使用制限です。
料金は使用量に依存しているため、大量に音声を生成する場合は予算に応じて計画的に使うことが求められます。API使用数を確認しながら調整する必要があります。

また、商用利用に際しては、エンドユーザーに対する情報提供やプライバシーの保護に対しても責任を持つ必要があります。これらを十分に理解したうえで、商用利用を進めることが大切です。

pyttsx3との比較

合成音声pyttsx3の場合は、PC搭載の読み上げ機能を使うためAPIを必要としません。
ただし、pyttsx3自体は商用利用できますが、読み上げソフトが商用利用できません。

【Python】合成音声pyttsx3使い方-テキストを読み上げ

Pythonの合成音声ライブラリ「pyttsx3」の基本的な使い方とその機能について。pyttsx3は、テキストの読み上げから、音声ファイルの生成、プロパティの変更に対応します。さらに、商用利用可能（ソフトは別途）や日本語、英語に対応。

alicia-ing.com

2024.11.26

要するに、個人で合成音声を使いたい場合は、pyttsx3を使用して、
ゲームやアプリのナレーションに追加したい場合は、
Google Text-to-Speechを使う必要があります。

Google Text-to-Speechの料金（無料枠）は？

無料枠の利用では、月に400万文字（WaveNetは100万文字）まで音声合成が可能です。
それを超えた場合は従量課金制で料金が発生します。

商用利用を検討している場合、Google Cloudの料金表を確認し、
必要な予算を見積もっておくことが重要です。

料金は、使用する声の種類や文字数に依存します。
例えば、標準的な音声とWaveNet音声（より自然な音声）では料金が異なります。

WaveNet音声はより高品質ですが、その分料金が高くなります。
また、使用する言語や地域によっても料金が変動することがありますので、
事前に詳細を確認することをお勧めします。

Google Cloudの無料利用枠を活用することで、コストを抑えながらプロトタイプを作成したり、個人プロジェクトで利用する際には、無料枠で十分対応できるケースが多いです。

ビジネス規模での利用に関しては、必要な予算を正確に把握し、
適切なプランを選択することが重要です。

Google Text-to-SpeechはMP3保存できる？

Google Text-to-Speechの音声合成はをMP3形式で保存することが可能です。

Pythonからテキストを取得して、そのままMP3またはWAV形式で保存することができます。この機能を使うことで、簡単にナレーション用の音声ファイルを生成することが可能になります。

例えば、教育コンテンツやオーディオブックの自動生成にMP3保存機能を活用することができます。音声ファイルは高音質で保存され、聞き取りやすいものとなります。

また、MP3形式で保存することで、さまざまなデバイスで再生可能な音声ファイルを作成することができます。これにより、ユーザーの利便性を高めることができ、プロジェクトの成功に寄与します。

WAV形式に比べてMP3形式はファイルサイズが小さいため、
オンラインでの共有やストレージの節約にも有利です。

Pythonを使用してMP3形式に保存することで、
音声ファイルの管理が簡単になり、アプリケーションの効率的な運用が可能となります。

作成した動画にナレーションを入れたい場合、
moviepyを併用することで、簡単にナレーション音声を導入できます。

【Python】moviepyできること｜mp3・GIF編集変換

MoviePyで動画編集を自動化！Pythonでカット、結合、リサイズからGIF変換まで簡単に行えるMoviePyの基本から応用的な使い方を徹底解説。動画編集を効率化したいプログラマーやSNS素材作成に挑戦したい方におすすめのガイドです。

alicia-ing.com

2024.11.22

Google Text-to-Speechの登録方法

Google Text-to-Speechを使うにはまずGoogle Cloudのアカウントを作成します。
「Google Cloud」にアクセスして、アカウント情報や支払い方法を入力します。

Cloud Speech-to-Textを有効にして、APIを取得します。

アカウント作成

「Text-to-Speechの無料トライアル」にアクセスし、Googleアカウントを用いてログインします。

アカウント作成する際に、支払い方法を登録（クレジットカード・デビットカードなど）する必要があります。

既に、Google広告やアドセンスに登録している場合は、再度追加しなくてもよいです。

アカウント作成が完了したら、Google Cloudのさまざまなサービスを利用するための準備が整います。

プロジェクトの管理は、Google Cloudコンソールから簡単に行えます。
プロジェクトの概要や利用状況の確認、APIの有効化など、必要な操作を行うことで、プロジェクトをスムーズに進められます。

Text-to-Speechを有効にする

ハンバーガーメニューから「APIとサービス>ライブラリ」に移動して、
「Cloud Text-to-Speech API」を有効にします。

見つけることができない場合は、検索バーから探します。

APIの有効化後、実際に音声合成のリクエストを行えるようになります。APIの有効化は簡単に行うことができ、あとは必要な認証情報を設定することでPythonから操作が可能です。

.jsonのAPIを取得

サイドバーから「IAMと管理>サービスアカウント」に進み、
サービスアカウントを作成します。

詳細情報に、サービスアカウント名を設定します。
指定すると自動でサービスアカウントIDが生成されます。

そのほかの情報は省略可能ですので、そのままで大丈夫です。

作成後、「操作」の3点マークから「鍵を管理」に進みます。

「キー」タブから「鍵を追加」を選択して、
JSONファイルを作成します。

JSONファイルには、APIにアクセスするための認証情報が含まれています。

このファイルを適切に管理することで、安全にGoogle Cloudのサービスを利用することが可能です。Pythonスクリプトからこのファイルを参照することで、
音声合成のリクエストを安全に行うことができます。

PythonでGoogle Text-to-Speechを操作

Google Text-to-Speech APIをPythonで操作することで、
CSVファイルに格納したテキストを音声ファイルに変換することができます。

CSVのA列に英単語を格納してそれを一行ずつ読み込んで音声合成し、
WAVファイルとして保存することが可能です。

Pythonを使うことで、業務での自動化や学習教材の作成など、さまざまなシーンで活用できます。
特に、複数のテキストを一括で音声化したい場合に便利です。

例えば、数百行にわたるテキストデータを自動で音声ファイルに変換し、
ナレーションやガイドとして利用することができます。

手作業で音声を録音する手間を大幅に削減することができ、
生産性を向上させることができます。

また、教育機関での学習用資料の作成や、自動応答システムの開発にも応用できます。

ソースコード

import os
import csv
from google.cloud import texttospeech

# 認証情報のパスを設定
os.environ['GOOGLE_APPLICATION_CREDENTIALS'] = 'key.json'

# 音声生成関数
def generate_audio(csv_path):
    # 保存先ディレクトリをCSVファイルと同じ場所に設定
    save_directory = os.path.dirname(csv_path)
    
    # Google Cloud TTSクライアントの作成
    client = texttospeech.TextToSpeechClient()
    
    # CSVファイルの読み込み
    with open(csv_path, 'r', newline='', encoding='utf-8') as csvfile:
        reader = csv.reader(csvfile)
        
        # 各行のA列を順番に処理
        for index, row in enumerate(reader):
            if len(row) > 0:  # A列に値があるか確認
                word = row[0]  # A列の単語を取得
                
                # テキスト入力の設定
                synthesis_input = texttospeech.SynthesisInput(text=word)
                
                # 音声の設定（en-US-Standard-J話者を使用）
                voice = texttospeech.VoiceSelectionParams(
                    language_code="en-US",
                    name="en-US-Standard-J"
                )
                
                # オーディオ設定
                audio_config = texttospeech.AudioConfig(
                    audio_encoding=texttospeech.AudioEncoding.LINEAR16  # WAVフォーマット
                )
                
                # 音声合成のリクエスト
                response = client.synthesize_speech(
                    input=synthesis_input,
                    voice=voice,
                    audio_config=audio_config
                )
                
                # ファイル名をインデックスと単語で作成し、保存先パスを設定
                filename = os.path.join(save_directory, f'{index+1}_{word}.wav')
                
                # 音声データの保存
                with open(filename, 'wb') as out:
                    out.write(response.audio_content)
                    print(f'Saved: {filename}')

# メイン処理
if __name__ == "__main__":
    # CSVファイルのパスを指定
    csv_path = 'voice.csv'
    
    # ファイルが存在するか確認
    if os.path.exists(csv_path):
        generate_audio(csv_path)
        print("音声変換が完了しました。")
    else:
        print("エラー: 指定されたCSVファイルが存在しません。")

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

解説

• モジュール名

「os」：ファイルシステムのパスや環境変数を扱うために使用されている。ここでは環境変数を設定し、CSVファイルの場所を扱うために必要。
「csv」：CSVファイルを読み込むために使用される。スクリプトでは、各行のA列の内容を音声生成のために取得する必要がある。
「google.cloud.texttospeech」：Google Cloud Text-to-Speech APIを利用するために必要。音声合成のリクエストを送るために使用されている。

• フィールド（メンバ変数）

「csv_path」：CSVファイルのパスを保持する。音声生成対象のファイルの場所を指定するために必要。
「save_directory」：音声ファイルの保存先ディレクトリのパスを保持する。CSVファイルと同じ場所に音声ファイルを保存するために使用。
「client」：Google Cloud Text-to-Speech APIクライアントのインスタンス。音声合成を行うために必要。
「word」：CSVファイルのA列から読み取った単語を保持する。この単語が音声合成の対象となる。
「synthesis_input」：音声合成に使用するテキストを保持する。Google Cloud Text-to-Speech APIに渡すために作成される。
「voice」：音声の設定を保持する。使用する言語コードと話者の情報が含まれ、どの話者を使って音声を生成するか指定する。
「audio_config」：オーディオ出力の設定を保持する。生成する音声のフォーマット（WAV形式）を指定する。
「filename」：生成した音声ファイルの保存先パスを保持する。インデックスと単語を使ってファイル名を作成。

generate_audioクラス

「csv_path」からCSVファイルを読み込み、A列の単語に対して音声を生成する関数。Google Cloud Text-to-Speech APIを利用して、各単語を音声ファイル（WAV形式）に変換し、CSVファイルと同じディレクトリに保存する。
まず「save_directory」をCSVファイルのディレクトリに設定し、APIクライアント「client」を生成する。

次に、CSVファイルを読み込み、各行に対してA列の単語を取得する。取得した単語を「synthesis_input」として設定し、音声の設定「voice」とオーディオ出力の設定「audio_config」を指定して「synthesize_speech」メソッドを呼び出し、音声を生成する。

最後に、生成した音声データを「filename」に保存する。ファイル名にはインデックスと単語を使っており、保存先ディレクトリに「.wav」ファイルとして保存する。

本ソースコードでは、「voice.csv」と先に指定しているが、
Tkinterを使うことでユーザーの設定によって決めることもできる。

【Python】Tkinterエントリー作成、初期値の取得を解説

PythonのTkinterでエントリーボックス（Entry）の解説をします。配置や文字列の取得、初期値、クリアなど基本事項を解説しながらログインフォームの制作しています。

alicia-ing.com

2025.04.29

実演

スクリプトを実行すると、csv（voice.csv）にのA列にあるテキストを読み込み、
wav形式で保存します。

wavファイルの保存先は、実行したPythonのコードと同じ断層です。

まとめ

Google Text-to-Speechは、テキストを簡単に音声に変換する強力なツールです。
特にPythonと組み合わせることで、柔軟に自動音声生成を行うことが可能になります。

本記事では、APIの取得からPythonによる実装までを詳細に解説しました。
業務の効率化や教育コンテンツの作成など、さまざまな用途で活用してみてください。

Google Text-to-Speechを使うことで、ナレーション、案内、教育用途、さらには商用プロジェクトでの音声合成など、多彩なシーンで活用することができます。

また、Pythonのコードを使えば、複数のテキストを自動的に音声ファイルに変換するプロセスを効率化でき、生産性を向上させることができます。

APIの設定や実装手順は一見複雑に思えますが、
本記事を参考にすれば初めての方でも問題なく取り組むことができるでしょう。

Google Cloudの無料枠を上手に利用し、まずは個人プロジェクトから始めてみるのも良いでしょう。音声合成の楽しさと可能性をぜひ体験してみてください。

面倒な手作業をスクリプトに置き換えることで効率的に編集作業を進められるこのライブラリは、動画のカットや結合、テキスト追加からGIFへの変換まで多岐にわたる機能を提供します。

本記事では、MoviePyの基本的な使い方から応用的な操作までをわかりやすく解説します。

moviepy

MoviePyは、Pythonで動画や音声を編集するオープンソースライブラリです。

動画のカットや結合、オーバーレイ、
速度変更など多くの機能を持ち、
mp4からGIFやmp3など他の形式への変換も簡単に行えます。

自動化された動画編集ワークフローを作るのに非常に役立つツールです。

基本的な機能

MoviePyを使って、基本的な動画編集を簡単に行うことができます。
以下に、主な機能とそれぞれのコード例を紹介します。

動画のカット（トリミング）

動画の特定の部分を切り取ることで、必要なシーンだけを抽出できます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4").subclip(10, 30)  # 10秒から30秒の部分を切り取る
clip.write_videofile("output_trimmed.mp4")

input_video.mp4の10秒から30秒までの部分を切り取って、
新しい動画ファイルとして保存します。

複数クリップの結合

複数の動画を連結して1つの動画にすることも簡単です。

from moviepy.editor import VideoFileClip, concatenate_videoclips

clip1 = VideoFileClip("video1.mp4").subclip(0, 10)
clip2 = VideoFileClip("video2.mp4").subclip(5, 15)

final_clip = concatenate_videoclips([clip1, clip2])
final_clip.write_videofile("output_concatenated.mp4")

video1.mp4の最初の10秒間とvideo2.mp4の5秒から15秒の部分を結合して、
新しい動画を作成しています。

筆者

最近のYouTubeは、総集編が多いので、
これで自動編集ができる！

動画のリサイズ

動画の解像度を変更して、特定のサイズにリサイズすることができます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4")
resized_clip = clip.resize(height=720)  # 高さを720ピクセルにリサイズ
resized_clip.write_videofile("output_resized.mp4")

動画の高さを720ピクセルに変更して、新しいファイルとして保存します。

UdemyでPythonを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

フレームレートの変更

フレームレートを変更することで、スムーズさを調整したり、特殊な演出を加えることができます。
フレームレートとは、動画やゲームにおいて1秒間に表示される画像（フレーム）の数を示す単位です。

要するに、1秒の動きを表現するために30枚の画像を使うと30fpsになります。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4").set_fps(15) # フレームレートを15fpsに変更
clip.write_videofile("output_changed_fps.mp4")

元の動画のフレームレートを15fpsに設定しています。

動画・画像の加工

MoviePyでは、動画や画像に対してさらに多くの加工を行うことが可能です。

機能として備わっていますが、
トリミングやオーバーレイ、テキストの追加は、
編集ソフトで動画作りした方がやりやすいです。

クロッピング（トリミング）

動画の一部を切り取ることで、不要な部分を削除し、必要な部分のみを残すことができます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4")
cropped_clip = clip.crop(x1=100, y1=50, x2=400, y2=300)  # 指定したエリアをクロップ
cropped_clip.write_videofile("output_cropped.mp4")

動画の特定のエリアをクロップして、新しい動画として保存します。

画像のオーバーレイ

動画の上に画像をオーバーレイすることが可能です。

from moviepy.editor import VideoFileClip, ImageClip, CompositeVideoClip

video_clip = VideoFileClip("input_video.mp4")
image_clip = ImageClip("overlay_image.png").set_duration(video_clip.duration)
image_clip = image_clip.set_position(("right", "top"))  # 画像の位置を右上に設定

composite_clip = CompositeVideoClip([video_clip, image_clip])
composite_clip.write_videofile("output_with_overlay.mp4")

input_video.mp4の上にoverlay_image.pngを右上に表示させています。

テキストの追加

動画上にテキストを追加することができます。

from moviepy.editor import VideoFileClip, TextClip, CompositeVideoClip

video_clip = VideoFileClip("input_video.mp4")
text_clip = TextClip("Hello, World!", fontsize=70, color='white').set_duration(5)
text_clip = text_clip.set_position('center').fadein(1).fadeout(1)  # フェードイン・フェードアウト効果

composite_clip = CompositeVideoClip([video_clip, text_clip])
composite_clip.write_videofile("output_with_text.mp4")

動画の中央に5秒間表示されるテキストを追加し、
フェードインとフェードアウト効果を加えています。

動画の回転

動画を任意の角度に回転させることができます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4")
rotated_clip = clip.rotate(90)  # 動画を90度回転
rotated_clip.write_videofile("output_rotated.mp4")

動画を90度回転させています。

動画・音声の効果

動画に視覚的な効果を加えることで、より魅力的なコンテンツを作成することができます。

また、音声を調整して臨場感がある動画作りができます。

フェードイン/フェードアウト

フェード効果を使って、動画の始まりや終わりを滑らかに演出します。

from moviepy.editor import VideoFileClip
from moviepy.video.fx import fadein, fadeout

clip = VideoFileClip("input_video.mp4")
clip_with_fadein = fadein.fadein(clip, 2)  # 最初の2秒をフェードイン
clip_with_fadeout = fadeout.fadeout(clip_with_fadein, 2)  # 最後の2秒をフェードアウト
clip_with_fadeout.write_videofile("output_fade.mp4")

最初の2秒間のフェードインと最後の2秒間のフェードアウトを加えています。

速度変更

動画の再生速度を変更することができます（スローモーションや早送り）。

from moviepy.editor import VideoFileClip, vfx

clip = VideoFileClip("input_video.mp4")
sped_up_clip = clip.fx(vfx.speedx, 2)  # 2倍速にする
sped_up_clip.write_videofile("output_sped_up.mp4")

動画を2倍速にして新しいファイルとして保存しています。

ミラーリング（反転）

動画を左右または上下に反転させることが可能です。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4")
mirrored_clip = clip.fx(vfx.mirror_x)  # 左右反転
mirrored_clip.write_videofile("output_mirrored.mp4")

動画を左右反転させています。

カラー調整

動画の色調（輝度、コントラスト、彩度など）を調整できます。

from moviepy.editor import VideoFileClip
from moviepy.video.fx import colorx

clip = VideoFileClip("input_video.mp4")
brightened_clip = colorx.colorx(clip, 1.5)  # 輝度を1.5倍に
brightened_clip.write_videofile("output_brightened.mp4")

動画の輝度を1.5倍に調整しています。

音声の追加/削除

動画の音声を削除したり、新しい音声を追加することができます。

from moviepy.editor import VideoFileClip, AudioFileClip

clip = VideoFileClip("input_video.mp4")
audio = AudioFileClip("new_audio.mp3").set_duration(clip.duration)
clip_with_new_audio = clip.set_audio(audio)
clip_with_new_audio.write_videofile("output_with_new_audio.mp4")

input_video.mp4に新しい音声ファイルnew_audio.mp3を追加しています。

音量調整

動画や音声クリップの音量を変更することができます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4")
quieter_clip = clip.volumex(0.5)  # 音量を半分に
quieter_clip.write_videofile("output_quieter.mp4")

動画の音量を半分にしています。

フェードイン/フェードアウト（音声）

音声クリップにフェード効果を加えることが可能です。

from moviepy.editor import VideoFileClip, AudioFileClip
from moviepy.audio.fx import audio_fadein, audio_fadeout

clip = VideoFileClip("input_video.mp4")
audio = clip.audio
faded_audio = audio_fadein.audio_fadein(audio, 2).fx(audio_fadeout.audio_fadeout, 2)
clip_with_faded_audio = clip.set_audio(faded_audio)
clip_with_faded_audio.write_videofile("output_faded_audio.mp4")

音声に最初と最後の2秒間のフェードイン・フェードアウト効果を追加しています。

応用例

MoviePyを使って、さらに複雑な動画編集を行うことも可能です。
以下にいくつかの応用例を紹介します。

動画に画像をオーバーレイ

動画の上にロゴや他の画像を追加することで、カスタマイズされた動画を作成することができます。

from moviepy.editor import VideoFileClip, ImageClip, CompositeVideoClip

video_clip = VideoFileClip("input_video.mp4")
image_clip = ImageClip("overlay_image.png").set_duration(video_clip.duration)
image_clip = image_clip.set_position(("right", "top"))  # 画像の位置を右上に設定

composite_clip = CompositeVideoClip([video_clip, image_clip])
composite_clip.write_videofile("output_with_overlay.mp4")

この例では、input_video.mp4の上にoverlay_image.pngを右上に表示させています。

テキストのアニメーション

動画上にアニメーション化されたテキストを追加して、より魅力的な演出を行います。

from moviepy.editor import VideoFileClip, TextClip, CompositeVideoClip

video_clip = VideoFileClip("input_video.mp4")
text_clip = TextClip("Hello, World!", fontsize=70, color='white').set_duration(5)
text_clip = text_clip.set_position('center').fadein(1).fadeout(1)  # フェードイン・フェードアウト効果

composite_clip = CompositeVideoClip([video_clip, text_clip])
composite_clip.write_videofile("output_with_text.mp4")

このコードでは、動画の中央に5秒間表示されるテキストを追加し、
フェードインとフェードアウト効果を加えています。

ピクチャー・イン・ピクチャー（PIP）効果

メインの動画の中に別の小さな動画を配置することで、
ピクチャー・イン・ピクチャー効果を実現します。

from moviepy.editor import VideoFileClip, CompositeVideoClip

main_clip = VideoFileClip("main_video.mp4")
small_clip = VideoFileClip("small_video.mp4").resize(height=150).set_position((10, 10)).set_duration(main_clip.duration)

pip_clip = CompositeVideoClip([main_clip, small_clip])
pip_clip.write_videofile("output_pip.mp4")

main_video.mp4の左上に小さなsmall_video.mp4を配置しています。

形式変換

MoviePyは動画のフォーマット変換もサポートしています。

MoviePyは多機能ですが、直感で編集できないので、用途が限られます。
しかし、動画を結合して、それをmp3やGIFに変換することで、
色々な場所で使うことができます。

例えば、私の場合は動画をGIFに変換してブログ投稿したり、
逆にGIFをmp4に変換して動画編集したりしています。

このように、フォーマットの変換はかなり使いやすいです。

mp3への変換

動画から音声を抽出してmp3ファイルとして保存できます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4")
clip.audio.write_audiofile("output_audio.mp3")

input_video.mp4の音声部分を抽出して、output_audio.mp3として保存します。

GIFへの変換

特定のシーンをGIFとしてエクスポートすることで、短いアニメーションを簡単に作成できます。

from moviepy.editor import VideoFileClip

clip = VideoFileClip("input_video.mp4").subclip(0, 5)  # 最初の5秒をGIFに変換
clip.write_gif("output.gif")

動画の最初の5秒間をGIFとしてエクスポートしています。

GIFをmp4に変換

GIFをインポートして、output.mp4をエクスポートしています。

from moviepy.editor import VideoFileClip

# GIFをmp4に変換
clip = VideoFileClip("input.gif")  # 入力GIFファイルを指定
clip.write_videofile("output.mp4", codec="libx264")  # mp4形式で出力

まとめ

MoviePyを使えば、Pythonで動画や音声を自由自在に編集することができます。

動画のカット、結合、リサイズ、エフェクト追加など、
MoviePyの基本機能を使いこなすことで、柔軟にコンテンツを作成することが可能です。

また、GIFやmp3などの形式に変換することも容易で、SNS用の素材作りにも最適です。

応用的な操作として、画像やテキストのオーバーレイ、ピクチャー・イン・ピクチャー効果などを利用することで、より高度で魅力的な動画編集が可能になります。

ぜひ本記事を参考に、MoviePyで様々な動画編集に挑戦してみてください！

ゲーム作りは企業が大人数で取り組むイメージかあるでしょうが、
個人でゲームを作成して爆発的ヒットを生み出している人もいます。

しかし個人でゲームを作った彼らは、
幼少期からプログラミングを始めている。
スクール通っていて、ゲーム会社で働いているときに作成しているなど

個人で作るにしても専門的かつキャリアが物を言います。
このように個人のゲーム作りは難しいものでした。

しかし、Unityを使うことでノンコードでもプロ顔負けのゲームを作ることができます。

Unityは最も人気で初心者からプロまで幅広く利用されるプラットフォームです。
最近では大手企業でも採用していています。

しかし高性能すぎて、いざインストールしてみても操作方法が分からない。
ある程度はC#が必要などUnityを挫折してしまう人が多いです。

著者の体験談

自分も挫折して戻ってきた一人です。

本記事では、自作ゲームの開発を目指している方に向けて、
Unityでの学び方とキャリアの可能性を示します。

ゲーム作り

ゲームには、滑らかな挙動が求められて、
使用言語は実行速度の速さに注目されます。

例えば、ゲーム使用される言語は、C++やJavaなどがあります。

表に挙げなかったPythonなどでも作ることができますが、マイナーです。

Javaは「Minecraft Java版」とあるようにマイクラが開発されたゲームですが、
環境を整えて、学習するにはコストがかかりすぎです。
メジャー言語の中ではトップクラスで難しいです。

したがって、基本的にゲーム開発は「C++」か「C#」のどちらかです。
両者の言語を使用したゲームエンジンが提供されています。

• 「C#」は、Unity。
• 「C++」は、Unreal Engine。

「C#」は「C++」よりも難易度が低いです。

一方で、「PlayStation」や「Nintendo Switch」などを有名なコンシューマーゲームは「C++」が使用されています。
「C++」の方がメモリやCPUの利用効率が良いことやゲーム開発言語として長年の歴史を持ちます。

UnityかUnreal Engine

UnityとUnreal Engineは、どちらもゲーム開発においてトップクラスのエンジンです。

UnityとUnreal Engineを比較して、どちらが自作ゲームに適しているかを考えます。

初めに価格帯について。

いずれも無料で始めることができます。
しかし、売り上げや資金調達金などによってはロイヤリティーを請求されます。

ドルは変動するので、各サービスで1ドル130円、150円と示しています。

150円で計算すると、Unityは6千万円。
Unreal Engineは、1億5千万円で使用料が必要になります。

閾値はUnityの方が低い（別プランあり）ですが、
Unreal Engine使用料は最低750万円（1億５千万×0.05）になります。

しかし１本1000円で販売した場合、６万本も販売するレベルになります。
個人開発者だとなかなか届かない数字なので、あまり気にする必要はありません。

情報量の観点から見ます。

ゲームエンジンの世界シェアは「Unity」が約46%を締め、次いで「Unreal Engine」が約17%を締めています。3位以下は企業独自に開発されたものが多いため、実質的には「Unity」と「Unreal Engine」の2つのゲームエンジンでほとんどのシェアを締めていると言ってもよいでしょう。ただし、最近ではXR分野においてUnityより有力との声もあります。

https://www.techfirm.co.jp/blog/unreal-engine

引用元から判断すると、Unityの方が利用者が多いようです。

利用者が多いということは情報量を示しているので、
分からないことやエラー文を調べれば解決しやすいです。

私がUnityを選んだ理由

私は、ノベルゲームを作りたくてゲーム作りに挑戦しました。
しかし、ノベルゲームはティラノビルダーというゲームエンジンがあります。

初めにどちらを使うか迷っていました。
また、ゲーム開発はC++であるUnreal Engineに使用かと思っていました。

最終的に決定打となったのは大学での実習です。
大学でArduinoの実験で、制作発表することがありました。

私は、ソフトウェアとハードウェアを連携したいと考えて、
ネットで検索していたところUnityの情報が多く制作を発表しました。
やはり、初学者には情報の多さはとても重要です。

Unityは、特に初心者にとって非常に学びやすく、多くのサポートリソースがあります。

豊富なチュートリアルやコミュニティの支援が受けられるため、
初学者でも独学しやすいのが特徴です。

また、Unityはクロスプラットフォーム対応が進んでおり、
一度の開発でさまざまな端末に対応できます。

Unityが活躍している業界は？

Unityはゲーム業界以外にも、次のようなさまざまな業界で使用されています。

私は講義の１環としてUnityを使いましたが、
研究室によってUnityを使っています。

• VR/AR：リアルな体験を提供するアプリケーションやシミュレーターに使用。
• 建築：建築モデルや不動産シミュレーションに。
• 教育：教育ゲームやインタラクティブな学習アプリとして。

Unityは、様々な業界で活躍するので、個人利用だけではなく、
就職や転職にも役立つスキルです。

Unityで作られた有名タイトル

Unityで開発されたゲームには、多くの有名タイトルがあります。
例を４つ出すと、

紹介したゲームタイトルから分かるように、
Unityは、大手のゲームメーカーでも採用されていて、マルチプレイが可能です。
さらに、ニンテンドースイッチやPC、スマホなど様々なプラットフォームにも対応しています。

Unity（C#）で傑作を作ることは可能です！

Unityの勉強方法

Unity以外にもプログラミングの学習方法は、
教本、ネット検索、生成AI、プログラミングスクール・専門学校、Udemyなどがあります。

各々は、学習という観点ではともに同じですが、
身につく学習としては差が出てきてしまいます。

上のそれぞれの方法とその特徴、メリット、デメリットについて紹介します。

教本

教本はインストールの方法から実際の開発まで体系的学べます。
しかし、自分が作りたいものをつくれるようになるかは別の話です。

参考書の問題は解けるようになったけど、模試や試験では解答ができない状況に似ています。

数学のように、解法を覚えて組み合わせるスキルが必要です。
教本で基本文法と操作を覚えたら、ゲーム作りをしづつけましょう。

ネット検索

Unityの開発者が多いので、ウェブページでソースコードを紹介している人が多いです。
Unity公式の学習マップもあります。

無料で大量の情報が手に入ります。
ただし、メモ代わりに公開する人が多いので、
情報が断片的です。

筆者

当サイトでは、Unityの役立つ情報を発信しています！
こちらからどうぞ～

初心者の場合は、絶対にゲームを完成させるという強い意志がないと挫折しやすいです。

生成AI

AIを活用して、特定の問題やコードの解決します。
また、作りたい機能を指示するだけで具体的な回答を得られることも特徴です。

ただし、AIの情報が不正確な場合があるため、何度も検証が必要になります。
指示がAIにとって曖昧だと目的のプログラムは組めません。

さらに、有料版に課金しないと利用制限がくるので、完成までに時間がかかります。

著者の体験談

まずは基本的な文法や機能を理解してから使うことをおすすめします。

プログラミングスクール・専門学校

独学では、学習が進まず勉強期間が不必要に長くなることがあります。

そんな時は、実際の現場で働くエンジニアに直接指導してもらえるプログラミングスクールや専門学校がおすすめです。

これらのスクールではコストがかかりますが、
「時間を買う」という観点で見れば、コストパフォーマンスは非常に良い選択肢です。

Udemy

Udemyは、Benesseと提携を結ぶLMSサイトで、
オンラインでプログラミングを学べるビデオ講座を提供するプラットフォームです。

非常に多くの講座があり、特定のスキルに特化したものから、包括的なプログラミングコースまで選ぶことができます。

筆者

実際の現場の人や大学教授が講師な場合もある！

頻繁にセールが開催されており、
95%OFFの破格な価格（1500円前後）で高品質な講座を受講することができます。

また、返金ポリシーに該当すれば30日間途中まで視聴していても全額返金も可能です。

ブログ運営

プログラミングの上達は、アウトプットです。

単純なアウトプットは製作物を作ることですが、
ブログに自分の書いたコードを公開することがおすすめです。

勉強と同じで人に教えることで自分の理解も深まります。
ブログでスクリプトを解説し、どの場面で使うかなど情報発信します。

著者の体験談

忘れたときには自分のブログを見ています。

UdemyでUnityを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

【Unity】学習ロードマップ｜自作ゲームを作りたい人必見！

Unityを使って自作ゲームを作りたい方必見。ゲームエンジン選択から学習方法、収益化の手段まで初心者向けにわかりやすく解説します。

alicia-ing.com

2025.08.11

Unityで稼ぐには？

Unityを使ってスキルを身に付けたら、
その技術を使って収益化することができます。

Unityは非常に柔軟なゲームエンジンであり、
その活用次第で様々な形で収入を得ることが可能です。

ここでは、Unityを使った具体的な稼ぎ方について解説します。

ゲームを公開する

Unityで作成したゲームを公開することで収益を得ることができます。

以下のようなプラットフォームでゲームをリリースすることで、
購入収益や広告収益を得ることが可能です。

各プラットフォームには、それぞれ異なる登録料や手数料が設定されています。
以下は、主なプラットフォームの手数料・登録料のまとめです。

• Steam

Steamは、Valve社が運営するインディーゲーム開発者向けの人気プラットフォームです。
PCゲームのリリースには最適で、広いユーザー層を持っています。

筆者

PCの場合はSteam一択！

手数料とは別に登録料が１タイトルごとに100ドルかかります。
ただし、そのタイトルが1000ドル売れることで返金されます。

筆者

15万円売るのは意外と厳しそう…

• BOOTH

BOOTHは、pixivが運営するクリエイター向けのマーケットプレイスで、
主に同人作品やデジタルコンテンツの販売に利用されています。

ゲームやアートワークなど、幅広い商品が販売されています。
pixivユーザーに向けて簡単に作品を宣伝・販売できる点が魅力です。

また、デジタルコンテンツを中心としたクリエイターが集まっているため、コミュニティ内での認知が得やすく、独自のターゲット層にアプローチできます。

無料で販売を始められるので、特に小規模での販売やテストマーケットに向いています。

筆者

駆け出しの場合は、BOOTHがおすすめ！

• Dlsite

Dlsiteは、日本で特に同人ゲームに強みを持つプラットフォームです。
ニッチな市場にアプローチする場合に非常に有効です。

手数料は、販売価格が格安ほど上がり、
最低価格の100円だと50円になります。

BOOTHと同様に無料で販売を始められるので、
とりあえず出品にも優しいです。

• Google、Apple

それぞれスマホやタブレットでゲームを販売するときに使用します。
いずれも登録料がかかります。

年間収益が100万ドル以下の場合、販売手数料は15%に減額されます。

案件を獲得する

Unityのスキルを活かして収入を得るには、案件を獲得する方法が効果的です。
そのためには、副業としての働き方と正社員としての転職活動、二つの選択肢があります。

それぞれの選択肢について、具体的にどのように活用できるかを詳しく説明します。

副業であれば、レバテックフリーランスがおすすめです。

レバテックフリーランスは、ITエンジニアやクリエイター向けに多くのフリーランス案件を提供しており、Unityを使ったゲーム開発案件も豊富にあります。

筆者

在宅からでも仕事を受けることが可能！

Unityのスキルを持っていれば、
短期・中期の開発案件に携わりながら収入を得ることが可能です。

特にリモートワークに対応した案件が多く、
自分のペースで働ける柔軟な働き方ができるのが大きな特徴です。

契約単価は比較的高いので、それなりの経験を求められます。
実務経験が必要な場合もあります。

エージェントのサポートにより、企業とのマッチングや契約交渉がスムーズに進むため、営業に慣れていない方でも安心して案件に参加できる環境が整っています。

筆者

ゲームを公開することで、実績を作ろう！

転職活動を通じてUnityのスキルを活かす場合、
レバテックキャリアを利用するのが効果的です。

レバテックキャリアITエンジニア向けの転職エージェントであり、
特にIT業界への転職に強みを持っています。

Unityを使ったゲーム会社のポジションには、モバイルゲームの開発からVRゲーム、メタバース関連の技術開発まで多様なプロジェクトがあります。

企業でのポジションを探す際に、キャリアアドバイザーのサポートを受けながら転職活動を進めることができます。

履歴書や職務経歴書の添削、面接対策などの支援を受けることで、
企業とのマッチングの精度を高め、スムーズに転職活動を行えるのが特徴です。

業界に精通したアドバイザーからは、業界の情報や転職のアドバイスを得られるため、求人情報を集める手間が省けるだけでなく、自分に最適なポジションにアクセスできる利点があります。

Unityのスキルを活かして案件を獲得するためには、
自分のライフスタイルやキャリアの目標に合わせて、フリーランスでの柔軟な働き方を選ぶか、転職を通じて安定したポジションを探すかを決めることが重要です。

それぞれの方法には異なる特徴と利点があるため、
自分に合った方法でスキルを活かし、経験を積みながら収入を得ることを目指してみてください。

筆者

個人で作るか、フリーランスか、正社員か…

まとめ

本記事では、Unityを使って自作ゲームを開発したい人に向けて、学習から収益化までの道のりを詳しく解説しました。

まず、UnityとUnreal Engineの比較を通して、Unityの特徴や選ぶ理由を示しました。

Unityを学ぶためのさまざまな方法を紹介し、
教本やオンライン講座、プログラミングスクールなど、それぞれの特徴を解説しました。

Unityのスキルを使って収益化する方法についても詳しく述べました。自作ゲームを公開するための主要プラットフォームについて、その手数料や登録料など具体的な情報を紹介し、どのプラットフォームがどのようなユーザーに適しているかについても触れました。

Unityを活用して案件を獲得する方法として、副業や転職の選択肢を説明しました。
フリーランスでの働き方、エージェントの活用方法、正社員としてゲーム業界でキャリアを築く手段について、それぞれの特徴を示しました。

Unityは初心者からプロフェッショナルまで幅広く活用できるゲームエンジンであり、正しい学習方法を選び、スキルをうまく活用することで、ゲーム開発の夢を実現すると同時に収入を得ることも可能です。

本記事を通じて、Unityでの学び方やキャリアの可能性について理解を深め、
自分の目標に合ったステップを踏み出してください。

画面クリックすると、複数のcsvを読み込む

Unityでゲームやアプリを開発する際にCSVファイル
シナリオやデータを簡単にロードできます。

特にシナリオ分岐や膨大なデータを管理する場合、
CSVを活用することで、プロジェクトの管理が飛躍的に楽になります。

本記事では、複数のCSVファイルをロードして、
それらをシーンや選択肢に応じて動的に切り替える方法を詳しく解説します。

.Clear()

Clear()メソッドは、コレクション（リストや配列など）に格納されたデータを削除し、空にするために使用されます。

複数のcsvを扱う際には、CSVデータを格納するリストcsvDataをクリアして、
次にロードされるCSVファイルのデータが重複しないように管理しています。

【Unity】CSVファイルを読み込み、テキストを画面に表示する

UnityでのCSVファイルの読み込み方法を解説します。エクセルやGoogleスプレッドシートでcsvを作成し、データのインポート・読み書き・外部ファイル読み込みを簡単に実装する方法を紹介。

alicia-ing.com

2025.08.12

void LoadCSV(TextAsset csvFile)
{
    csvData.Clear(); // 前のデータをクリア
    Line = 0; // 行番号をリセット
    // CSVデータの読み込み処理
}

次のCSVファイルをロードする際に前のデータを一旦クリアすることで、
新しいデータが正常に読み込まれ、余計なバグを防ぐことができます。

csvファイルの読み込みを変更する

複数のCSVファイルを順に読み込む際に、
特定の条件やタイミングでファイルを変更したり、
次のCSVファイルに切り替える方法を学ぶことが重要です。

本スクリプトでは、index変数を使って現在のCSVファイルを追跡し、
すべての行を表示し終わったら次のファイルに自動的に切り替えます。

機能として、画面クリックでindex変数を進めます。

【Unity】UIテキスト表示と使い方ー画面を押して文字を変える

この記事は、Unityでのテキスト表示について解説しています。Debug.Log()とUIテキストの違い、TextMeshProの使用法を説明し、初心者向けにノベルゲームの基礎の機能を紹介。

alicia-ing.com

2025.05.18

ソースコード

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using System.IO;
using TMPro; // TextMeshProの追加

public class Multicsv : MonoBehaviour
{
    public TextMeshProUGUI DisplayText; // 表示するテキストUI
    public TextAsset[] csvFiles; // CSVファイル配列

    private List<string[]> csvData = new List<string[]>();
    private int Line = 0;
    private int index = 0;

    void Start()
    {
        if (csvFiles.Length > 0)
        {
            LoadCSV(csvFiles[index]); // 最初のCSVファイルをロード
            DisplayNextLine();
        }
        else
        {
            Debug.LogError("CSVファイルがアタッチされていません。");
        }
    }

    void Update()
    {
        if (Input.GetMouseButtonDown(0)) // クリックで次の行へ
        {
            DisplayNextLine();
        }
    }

    // CSVをロードするメソッド
    void LoadCSV(TextAsset csvFile)
    {
        csvData.Clear(); // 前のデータをクリア
        Line = 0; // 行番号をリセット

        StringReader reader = new StringReader(csvFile.text);

        while (reader.Peek() != -1)
        {
            string line = reader.ReadLine();
            csvData.Add(line.Split(',')); // CSVファイルの各行をリストに追加
        }

        Debug.Log(csvFile.name + "をロードしました");
    }

    void DisplayNextLine()
    {
        if (Line >= csvData.Count)
        {
            // 現在のCSVが終わったら次のCSVに切り替える
            index++;

            if (index < csvFiles.Length)
            {
                LoadCSV(csvFiles[index]); // 次のCSVファイルをロード
                DisplayNextLine(); // 次の行を表示
            }
            else
            {
                Debug.Log("すべてのCSVファイルを表示しました。");
            }
            return;
        }

        string[] lineData = csvData[Line];

        // テキストの表示
        DisplayText.text = lineData[0]; // テキスト内容は2列目にあると仮定
        Line++;
    }
}

UdemyでUnityを学習

Udemyは、オンデマンド式の学習講座です。
趣味から実務まで使えるおすすめの講座を紹介します。

【Unity】学習ロードマップ｜自作ゲームを作りたい人必見！

Unityを使って自作ゲームを作りたい方必見。ゲームエンジン選択から学習方法、収益化の手段まで初心者向けにわかりやすく解説します。

alicia-ing.com

2025.08.11

解説

• 名前空間

「System.Collections」：コレクションを扱うために必要な名前空間で、リストなどのデータ構造を利用するために使います。
「System.Collections.Generic」：ジェネリックコレクションを扱うために必要な名前空間で、型指定したリストなどを使うために使用します。
「UnityEngine」：Unityの基本的なクラスや関数（例えば、MonoBehaviourやDebug.Logなど）を使うために必要です。
「System.IO」：ファイルの入出力操作を行うための名前空間で、CSVファイルの内容を読み込むために使用しています。
「TMPro」：TextMeshProを使ってUIにテキストを表示するために必要な名前空間です。

【Unity】TextMeshPro-日本語表示とスクリプト制御

UnityのTextMeshProは日本語のテキストを美しく表示し、スクリプトでテキストを動的に変更することも可能です。改行は"\n"でします。"japanese_full.txt"ファイルを読み込んでTextMeshProに適用します。

alicia-ing.com

2025.08.11

• フィールド（メンバ変数）

「DisplayText」：ゲーム内に表示するテキストUIコンポーネントを参照します。
「csvFiles」：複数のCSVファイルを配列として保持し、順に読み込むために使います。
「csvData」：現在読み込まれているCSVファイルのデータを行ごとに保持するリストです。
「Line」：現在表示しているCSVデータの行番号を管理します。
「index」：現在読み込んでいるCSVファイルのインデックスを管理します。

• Startメソッド

csvFilesにアタッチされたCSVファイルをロードし、1行目を表示します。
もしファイルがアタッチされていなければエラーメッセージを表示します。

• Updateメソッド

ユーザーのクリック入力を検知します。
クリックされるとDisplayNextLineメソッドを呼び出して次の行を表示します。

【Unity】マウス操作をゲームに導入する画面クリックで処理

UnityでCSVのテキストをマウスクリックで１つずつ進めるには、if文でメソッド「Input.GetMouseButtonDown(0)」を使用します。ノベルゲームは画面のクリック回数に応じてテキストを表示するシステムに近づきます。

alicia-ing.com

2025.08.11

• LoadCSVメソッド

指定されたCSVファイルの内容をリストcsvDataに読み込みます。
リストcsvDataをクリアし、行番号をリセットします。

StringReaderを用いてCSVファイルの各行を読み込み、
それをカンマ区切りで分割してリストに格納します。

• DisplayNextLineメソッド

現在の行番号に対応するCSVデータをUIに表示します。
すべての行を表示し終わったら次のCSVファイルに切り替えます。

全てのCSVファイルを表示し終わった場合、処理が終了します。

実演

画面上にテキストUIを配置します。

Resourcesフォルダー内にcsvを用意し、
これらをアタッチします。

クリックごとにUpdateメソッドが呼ばれ、
現在のCSVファイルのすべての行を表示し終わったら、次のCSVファイルをロードします。

すべてのCSVファイルを表示し終わった場合は、終了メッセージを表示します。

CSVファイルは、LoadCSVメソッドを使ってテキストとして読み込まれ、
その内容をカンマ区切りでリストに保存します。

まとめ

Unityで複数のCSVファイルをロードして分岐シナリオを作成する方法を解説しました。

Clear()メソッドを使って前のデータをクリアしたり、index変数で次のファイルを動的に切り替えることで、柔軟にファイル管理ができます。

このシステムを使うことで、分岐シナリオや大規模なデータを効率的に管理し、スムーズなゲーム体験を提供できます。