Unityエディタリソースインポート処理関数OnPostprocessAudioの使い方

表紙をクリックするとダウンロードページに飛びます

導入

Unityではエディターリソースインポート処理機能( OnPostprocessAudio)を利用してオーディオリソースのインポート処理をカスタマイズすることができます。この関数はクラスから継承されておりAssetPostprocessor、この関数を書き換えることで、オーディオリソースのインポート後にいくつかのカスタム操作を実行できます。

アセットの継承ポストプロセッサ

AssetPostprocessorまず、継承するスクリプトを作成する必要があります。このスクリプトは、オーディオアセットのインポートプロセスを処理するために使用されます。サンプルコードは次のとおりです。

using UnityEditor;
using UnityEngine;

public class AudioPostprocessor : AssetPostprocessor
{
    void OnPostprocessAudio(AudioClip clip)
    {
        // 在这里编写自定义的音频导入处理逻辑
    }
}

AudioPostprocessorこの例では、というスクリプトを作成し、OnPostprocessAudio関数をオーバーライドしました。

カスタムオーディオインポート処理ロジック

この関数ではOnPostprocessAudio、カスタムのオーディオインポート処理ロジックを作成できます。以下は、オーディオリソースをインポートした後にそのプロパティを変更する方法を示すサンプルコードです。

using UnityEditor;
using UnityEngine;

public class AudioPostprocessor : AssetPostprocessor
{
    void OnPostprocessAudio(AudioClip clip)
    {
        // 将音频的音量设置为0.5
        AudioImporter audioImporter = (AudioImporter)assetImporter;
        AudioImporterSampleSettings sampleSettings = audioImporter.defaultSampleSettings;
        sampleSettings.volume = 0.5f;
        audioImporter.defaultSampleSettings = sampleSettings;
    }
}

この例では、オーディオインポーター ( AudioImporter) を使用し、そのデフォルトのサンプリング設定 ( defaultSampleSettings) を変更します。オーディオの音量を 0.5 に設定して、インポート後にオーディオを再生すると、その音量が半分に減ります。

ニーズに応じて、カスタムオーディオインポート処理ロジックを作成できます。たとえば、オーディオ圧縮設定の変更、ループプロパティの設定、タグの追加などを行うことができます。

OnPostprocessAudio 関数を使用する

OnPostprocessAudio関数を使用するには、AssetPostprocessorプロジェクト内の任意の場所から継承したスクリプトを配置するだけです。オーディオアセットをインポートすると、Unity は自動的にOnPostprocessAudio関数を呼び出し、作成したカスタムロジックを実行します。

OnPostprocessAudioこの関数は、オーディオリソースが更新または削除されたときではなく、オーディオリソースがインポートされたときにのみ呼び出されることに注意してください。

サンプルコード

using UnityEditor;
using UnityEngine;

public class MyAudioPostprocessor : AssetPostprocessor
{
    void OnPostprocessAudio(AudioClip audioClip)
    {
        // 获取导入的音频资源
        AudioImporter audioImporter = assetImporter as AudioImporter;

        // 根据不同平台设置音频的压缩格式
        SetCompressionFormat(audioImporter);

        // 根据不同平台设置音频的加载方式
        SetLoadType(audioImporter);

        // 调整音频的音量
        AdjustVolume(audioClip);

        // 设置资源打包标签
        SetAssetBundleTag(audioImporter);

        // 根据不同平台设置音频的采样率
        SetSampleRate(audioImporter);
    }

    // 根据不同平台设置音频的压缩格式
    private void SetCompressionFormat(AudioImporter audioImporter)
    {
        AudioImporterSampleSettings sampleSettings = audioImporter.defaultSampleSettings;

        // Android 平台使用 OGG 压缩格式
        if (EditorUserBuildSettings.activeBuildTarget == BuildTarget.Android)
        {
            sampleSettings.compressionFormat = AudioCompressionFormat.Vorbis;
        }
        // iOS 平台使用 AAC 压缩格式
        else if (EditorUserBuildSettings.activeBuildTarget == BuildTarget.iOS)
        {
            sampleSettings.compressionFormat = AudioCompressionFormat.AAC;
        }
        // 其他平台使用 MP3 压缩格式
        else
        {
            sampleSettings.compressionFormat = AudioCompressionFormat.MP3;
        }

        audioImporter.defaultSampleSettings = sampleSettings;
    }

    // 根据不同平台设置音频的加载方式
    private void SetLoadType(AudioImporter audioImporter)
    {
        AudioImporterLoadType loadType = AudioImporterLoadType.CompressedInMemory;

        // Android 平台使用解压缩加载方式
        if (EditorUserBuildSettings.activeBuildTarget == BuildTarget.Android)
        {
            loadType = AudioImporterLoadType.StreamFromDisc;
        }

        audioImporter.loadType = loadType;
    }

    // 调整音频的音量
    private void AdjustVolume(AudioClip audioClip)
    {
        float[] audioData = new float[audioClip.samples * audioClip.channels];
        audioClip.GetData(audioData, 0);
        for (int i = 0; i < audioData.Length; i++)
        {
            audioData[i] *= 0.5f; // 调整音量为原来的一半
        }
        audioClip.SetData(audioData, 0);
    }

    // 设置资源打包标签
    private void SetAssetBundleTag(AudioImporter audioImporter)
    {
        audioImporter.assetBundleName = "AudioBundle";
        audioImporter.assetBundleVariant = "unity3d";
    }

    // 根据不同平台设置音频的采样率
    private void SetSampleRate(AudioImporter audioImporter)
    {
        AudioImporterSampleSettings sampleSettings = audioImporter.defaultSampleSettings;

        // Android 平台设置采样率为 44100
        if (EditorUserBuildSettings.activeBuildTarget == BuildTarget.Android)
        {
            sampleSettings.sampleRateSetting = AudioSampleRateSetting.OverrideSampleRate;
            sampleSettings.sampleRateOverride = 44100;
        }
        // iOS 平台设置采样率为 48000
        else if (EditorUserBuildSettings.activeBuildTarget == BuildTarget.iOS)
        {
            sampleSettings.sampleRateSetting = AudioSampleRateSetting.OverrideSampleRate;
            sampleSettings.sampleRateOverride = 48000;
        }
        // 其他平台使用默认采样率
        else
        {
            sampleSettings.sampleRateSetting = AudioSampleRateSetting.PreserveSampleRate;
        }

        audioImporter.defaultSampleSettings = sampleSettings;
    }
}

上記のコードでは、さまざまなプラットフォームでオーディオリソースの最高の効果とパフォーマンスを確保するために、さまざまなプラットフォームに応じてさまざまなインポート設定を設定しています。オーディオの長さに応じて、適切な読み込み方法、適切なビットレート、および適切なサンプリングレートを取得し、これらの設定をオーディオインポーターのデフォルトのサンプリング設定に適用します。

サンプルコードの判定ロジックは簡単な例であり、実際のニーズに応じて変更、拡張することができます。

上記のサンプルコードを通じて、独自のニーズに応じてオーディオリソースをカスタマイズし、インポート効果とユーザーエクスペリエンスを向上させることができます。

要約する

Unityのエディタリソースインポート処理機能を利用することでOnPostprocessAudio、オーディオリソースのインポート完了後にカスタム処理ロジックを実行することができます。これにより、プロジェクトのニーズに応じてオーディオリソースのプロパティと設定を変更し、オーディオリソースをより適切に制御および管理できるようになります。

私の技術記事に誤りがある可能性があることを心よりお詫び申し上げます。情報が正確で信頼できるものであることを保証するための努力が払われていますが、技術情勢は常に変化しているため、間違いは避けられません。バグを見つけた場合やご質問がある場合は、私までご連絡ください。間違いを修正し、より正確な情報を提供できるよう最善を尽くします。

改めて心よりお詫び申し上げます。より良い読書体験と正確な技術情報を提供するために、より慎重に記事を見直し、更新していきます。

ご理解とご支援をよろしくお願いいたします。

Unityエディターのリソースインポート処理機能OnPostprocessAudio：徹底した分析と実践事例