友人に「Bot で Voice Channel に音楽流せない？」と相談を受けました。Discord Bot で音声を扱う実装はしたことがなく、気になったのでパパッと調べてみました。覚書ということで丁寧な解説などはありません。
<h1 id="%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99" data-line="3" class="code-line">
<a class="header-anchor-link" href="#%E4%BA%8B%E5%89%8D%E6%BA%96%E5%82%99" aria-hidden="true"></a> 事前準備</h1>
<code>Discord.Audio</code> を利用するためには <code>ibsodium.dll</code> と <code>opus.dll</code> を実行時フォルダ (= パスが通ったところ) に置いておく必要があります。これは Discord.NET のドキュメントにも明記されています。
<ul data-line="6" class="code-line">
<li data-line="6" class="code-line"><a href="https://docs.discordnet.dev/guides/voice/sending-voice.html" target="_blank" rel="nofollow noopener noreferrer">https://docs.discordnet.dev/guides/voice/sending-voice.html</a></li>
</ul>
<blockquote data-line="8" class="code-line">
Audio requires two native libraries, libsodium and opus. Both of these libraries must be placed in the runtime directory of your bot. (When developing on .NET Framework, this would be bin/debug, when developing on .NET Core, this is where you execute dotnet run from; typically the same directory as your csproj).
</blockquote>
特にドキュメントも読まずに実装して、いざ実行しようとしたら「opus.dll がない」と怒られ続けてしばらく悩みました。ドキュメントはちゃんと読みましょう。
<h1 id="%E5%AE%9F%E8%A3%85" data-line="13" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A3%85" aria-hidden="true"></a> 実装</h1>
<h2 id="step.1-%3A-voice-channel-%E3%81%B8%E3%81%AE%E6%8E%A5%E7%B6%9A" data-line="15" class="code-line">
<a class="header-anchor-link" href="#step.1-%3A-voice-channel-%E3%81%B8%E3%81%AE%E6%8E%A5%E7%B6%9A" aria-hidden="true"></a> Step.1 : Voice Channel への接続</h2>
Discord API への接続処理などは割愛し、Voice Channel に参加して音声データを流す部分だけをピックアップします。
<div class="code-block-container"><pre class="language-csharp"><code class="language-csharp code-line" data-line="18">// 接続済みのクライアントがあるとする
DiscordSocketClient socketClient;

// 指定した Voice Channel に接続
var guild = socketClient.GetGuild(id: ..); // サーバー ID
var channel = guild.GetVoiceChannel(id: ..); // チャンネル ID
var audioClient = await channel.ConnectAsync();

// 音声データを再生
using (var audioStream = audioClient.CreatePCMStream(AudioApplication.Mixed))
{
 // audioStream に対して PCM 形式のバイト列を流し込めば音声が流れる
}
</code></pre></div><h3 id="audioapplication-%E3%81%AE%E6%84%8F%E5%91%B3" data-line="34" class="code-line">
<a class="header-anchor-link" href="#audioapplication-%E3%81%AE%E6%84%8F%E5%91%B3" aria-hidden="true"></a> <code>AudioApplication</code> の意味</h3>
どうやら音声の品質を指定するためにあるようです。用途に合わせて調整しましょう。
<table data-line="37" class="code-line">
<thead data-line="37" class="code-line">
<tr data-line="37" class="code-line">
<th>
<code>AudioApplication</code> の値</th>
<th>音質</th>
<th>帯域幅</th>
<th>遅延</th>
<th>主な用途</th>
</tr>
</thead>
<tbody data-line="39" class="code-line">
<tr data-line="39" class="code-line">
<td><code>Voice</code></td>
<td>声に最適</td>
<td>狭い</td>
<td>少ない</td>
<td>通話 / 読み上げ</td>
</tr>
<tr data-line="40" class="code-line">
<td><code>Mixed</code></td>
<td>標準</td>
<td>標準</td>
<td>標準</td>
<td>効果音 / 通知音</td>
</tr>
<tr data-line="41" class="code-line">
<td><code>Music</code></td>
<td>高音質</td>
<td>広い</td>
<td>多い</td>
<td>BGM 再生</td>
</tr>
</tbody>
</table>
<h2 id="step.2-%3A-.mp3-%E3%82%92%E5%86%8D%E7%94%9F" data-line="44" class="code-line">
<a class="header-anchor-link" href="#step.2-%3A-.mp3-%E3%82%92%E5%86%8D%E7%94%9F" aria-hidden="true"></a> Step.2 : .mp3 を再生</h2>
音声データを扱うライブラリは何でもよいと思いますが、今回は <a href="https://github.com/naudio/NAudio" target="_blank" rel="nofollow noopener noreferrer">NAudio</a> を利用してみます。手元にある .mp3 形式のファイルを流し込むだけであれば以下のような感じでたった数行で実装が終わります。お手軽。
<div class="code-block-container"><pre class="language-csharp"><code class="language-csharp code-line" data-line="47">using (var audioStream = audioClient.CreatePCMStream(AudioApplication.Mixed))
{
 // NAudio を利用して .mp3 ファイルを PCM 形式の Stream に変換
 const string path = @"&lt;Path to Audio&gt;.mp3";
 using (var reader = new Mp3FileReader(path))
 {
 // Discord.NET 内部で OpusEncoder が 48,000 Hz を要求しているので合わせること
 var format = new WaveFormat(sampleRate: 48000, channels: 2); 
 using (var pcmStream = new WaveFormatConversionStream(format, reader))
 {
 // 音声データを Discord に流し込む
 await pcmStream.CopyToAsync(audioStream);
 }
 }
}
</code></pre></div><h3 id="%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A0%85" data-line="65" class="code-line">
<a class="header-anchor-link" href="#%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A0%85" aria-hidden="true"></a> 注意事項</h3>
ただし、正直なところ NAudio は以下を理由に積極的な利用はしない方がよいのではないかという気はしています。
<ul data-line="68" class="code-line">
<li data-line="68" class="code-line">Windows でしか動作しない</li>
<li data-line="69" class="code-line">.NET 6 (= サポート期限切れ) までしかサポートしていない</li>
</ul>
上記は本記事執筆時点での話で、今後のアップデートで改善されるかもしれません。今回はとりあえず技術検証をしたいだけなので許容しています。

Discord.NET を利用した Voice Channel に対する音声データ再生

Discussion