🔊

.NET10 の Blazor Web App で音を鳴らす

に公開
2026/01/26

はじめに

.NET 10では、JavaScript側のnewを直接呼び出せるInvokeConstructorAsyncが使えるようになり、C#だけで任意のJSオブジェクトのインスタンスが生成可能になりました。

今回、音を鳴らす必要があって、使ってみたら便利だったので記録を残します。

前提

  • .NET 10
  • Windows版 Google Chrome 144

実証

取り敢えず、以下のコードだけで鳴らせます。

PlayAudio.razor
@rendermode InteractiveServer
@inject IJSRuntime JSRuntime
@if (SeWalk is not null) {
    <button @onclick=@(async () => await SeWalk.InvokeVoidAsync ("play"))>効果音再生</button>
}
@code {
    /// <summary>参照</summary>
    protected IJSObjectReference? SeWalk;
    /// <summary>遅延初期化</summary>
    protected override async Task OnAfterRenderAsync (bool firstRender) {
        await base.OnAfterRenderAsync (firstRender);
        if (firstRender) {
            SeWalk ??= await JSRuntime.InvokeConstructorAsync ("Audio", "《音声ファイルのパス》");
            StateHasChanged ();
        }
    }
}

JavaScript相互運用機能を利用するためには、ページのレンダリングが完了して機能が利用可能になるまで待機する必要があります。
インスタンス生成(InvokeConstructorAsync)では、最初の引数にクラス名、以降でコンストラクタの引数を渡しています。
つまり、最初のレンダリング後に、new Audio(~)に音声ファイルのパスを渡して、JSのAudioインスタンスを得ます。
音声ファイルは、wwwroot/audios/~とかに入れてあって、パスはaudios/~になる想定です。

再生時は、インスタンスに.play()を実行させます。
ブラウザのポリシーで、ユーザの操作のない状態で音を鳴らそうとすると例外が生じるかもしれません。

実装

効果音とジングル用の簡易な実装例です。
同じ音は複数同時に鳴りませんし、音を止めたりループさせたりといった制御も行いません。
さすがに、ページ遷移の際には音を止めて、ついで(念のため)にリソースを解放しています。

PlayAudio.razor
@rendermode InteractiveServer
@implements IAsyncDisposable
@inject IJSRuntime JSRuntime

<button @onclick="async () => await SeWalk.PlayAudioAsync ()">効果音再生</button>

@code {
    /// <summary>効果音 歩く</summary>
    protected IJSObjectReference? SeWalk;

    /// <summary>遅延初期化</summary>
    protected override async Task OnAfterRenderAsync (bool firstRender) {
        await base.OnAfterRenderAsync (firstRender);
        if (firstRender) {
            // 効果音読み込み
            SeWalk ??= await JSRuntime.CreateAudioAsync ("audios/walk.mp3");
        }
    }

    /// <summary>破棄</summary>
    public async ValueTask DisposeAsync () {
        // Audioインスタンス破棄
        if (SeWalk is not null) {
            await SeWalk.DisposeAudioAsync ();
            SeWalk = null;
        }
    }
}
JSAudioHelper.cs
/// <summary>JSAudioのための拡張</summary>
public static class JSAudioHelper {

    /// <summary>Audioインスタンスの生成</summary>
    /// <param name="jSRuntime">IJSRuntime</param>
    /// <param name="source">Audioソース</param>
    public static async ValueTask<IJSObjectReference?> CreateAudioAsync (this IJSRuntime jSRuntime, string source) {
        var audio = (IJSObjectReference?) null;
        try {
            audio = await jSRuntime.InvokeConstructorAsync ("Audio", source);
            await audio.InvokeVoidAsync ("load");
        }
        catch (JSException ex) {
            System.Diagnostics.Debug.WriteLine ($"CreateAudioAsync catch exception: {ex.Message}\n{ex.StackTrace}");
        }
        return audio;
    }

    /// <summary>Audio再生</summary>
    /// <param name="audio">Audio JSオブジェクト</param>
    public static async ValueTask PlayAudioAsync (this IJSObjectReference? audio) {
        if (audio is not null) {
            try {
                await audio.InvokeVoidAsync ("play");
            }
            catch (JSException ex) {
                System.Diagnostics.Debug.WriteLine ($"PlayAudioAsync catch exception: {ex.Message}\n{ex.StackTrace}");
            }
        }
    }

    /// <summary>Audioを解放</summary>
    /// <param name="audio">Audio JSオブジェクト</param>
    public static async ValueTask DisposeAudioAsync (this IJSObjectReference? audio) {
        if (audio is not null) {
            try {
                await audio.InvokeVoidAsync ("pause");
                await audio.InvokeVoidAsync ("removeAttribute", "src");
                await audio.InvokeVoidAsync ("load");
            }
            catch (JSException ex) {
                System.Diagnostics.Debug.WriteLine ($"DisposeJSAudioAsync catch exception: {ex.Message}\n{ex.StackTrace}");
            }
            finally {
                await audio.DisposeAsync ();
            }
        }
    }

}

資料

https://learn.microsoft.com/ja-jp/aspnet/core/release-notes/aspnetcore-10.0?view=aspnetcore-10.0#new-javascript-interop-features

https://learn.microsoft.com/ja-jp/dotnet/api/microsoft.jsinterop.implementation.jsobjectreference.invokeconstructorasync?view=aspnetcore-10.0

https://learn.microsoft.com/ja-jp/dotnet/api/microsoft.jsinterop.jsruntimeextensions.invokevoidasync?view=aspnetcore-10.0

https://learn.microsoft.com/ja-jp/dotnet/api/microsoft.jsinterop.jsruntimeextensions.invokeasync?view=aspnetcore-10.0

https://learn.microsoft.com/ja-jp/dotnet/api/microsoft.jsinterop.ijsobjectreference?view=aspnetcore-10.0

https://developer.mozilla.org/ja/docs/Web/API/HTMLAudioElement

https://developer.mozilla.org/ja/docs/Web/Media/Guides/Audio_and_video_delivery#音声と動画に関するその他のヒント

おわりに

C#だけでJS操作が完結できて、とても便利ですね。
あとは、リアルタイムキー入力があればゲーム開発が捗るのですが…。

最後までお読みいただきありがとうございました。
お気づきの点があればお知らせいただけると助かります。

Discussion