discorb-voice 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fea20d97b1be8d5c3e395d50d4a1cfa1b2de4b926be3610acfda6d16b8ecdf27
+  data.tar.gz: 7810db23cdd333483653881e9c629844e6963359e106677520b5c2569a0f45b4
+SHA512:
+  metadata.gz: 4097e618d134677434518ab6d94d5a7f35c524c1248c16666fc2246c59f31a8685c7d4ed080a3c28cd6de222ea04346daa44805a2afa94f94994cb26fc7bb9c7
+  data.tar.gz: a97ab6487013e35614252008948acff3a7177bf637066ec35b480852d9e3a84332d7196d7f89dc6099f176d7fd444ee9984f9be3a41a25c4ebaaff323113b785

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+Gemfile.lock

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2021-09-11
+
+- Initial release

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in discorb-voice.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "discorb", path: "../discorb"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 sevenc-nanashi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,120 @@
+# discorb-voice
+
+This adds a voice support to discorb.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'discorb-voice'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install discorb-voice
+
+### Install libsodium
+
+#### Windows
+
+Get libsodium from [here](https://download.libsodium.org/libsodium/releases/).
+I've checked `libsodium-1.0.17-stable-mingw.tar.gz` works.
+
+Then, if you are using x64 ruby (Check with `ruby -e 'puts RUBY_PLATFORM'`)...
+1. extract `libsodium-win64`
+2. copy `libsodium-23.dll` in `bin` to `C:/Windows/System32/sodium.dll`
+
+If you are using x86 ruby...
+1. extract `libsodium-win32`
+2. copy `libsodium-23.dll` in `bin` to `C:/Windows/SysWOW64/sodium.dll`.
+
+#### Linux
+
+    $ sudo apt-get install libsodium-dev
+
+Get libsodium with your package manager.
+
+#### Mac
+
+    $ brew install libsodium
+
+### Install ffmpeg
+
+#### Windows
+
+Get ffmpeg from [here](https://ffmpeg.org/download.html).
+And put the `ffmpeg.exe` on your PATH.
+
+Or, you can use Chocolatey to install ffmpeg:
+
+    $ choco install ffmpeg
+
+#### Linux
+
+    $ sudo apt-get install ffmpeg
+
+Use your package manager to install ffmpeg.
+
+#### Mac
+
+    $ brew install ffmpeg
+
+## Usage
+
+```ruby
+require "discorb"
+require "discorb-voice"
+
+
+client.once :standby do
+  puts "Logged in as #{client.user}"
+end
+
+client.slash "connect", "connect to a voice channel" do |interaction|
+  channel = interaction.target.voice_state.channel
+  interaction.post "Connecting to #{channel.name}"
+  channel.connect.wait
+  interaction.post "Connected to #{channel.name}"
+end
+
+client.slash "play", "Plays audio" do |interaction|
+  interaction.guild.voice_client.play(Discorb::Voice::FFmpegAudio.new("./very-nice-song.mp3"))
+  interaction.post "Playing Your very nice song!"
+end
+
+client.slash "stop", "Stops the current audio" do |interaction|
+  interaction.guild.voice_client.stop
+  interaction.post "Stopped"
+end
+
+client.run(ENV["DISCORD_BOT_TOKEN"])
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/discorb-lib/discorb-voice.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Acknowledgments
+
+The implementation of the voice client is based on [discord.py](https://github.com/Rapptz/discord.py) library.
+
+```
+Copyright (c) 2015-present Rapptz
+Released under the MIT license
+https://github.com/Rapptz/discord.py/blob/master/LICENSE
+```

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "discorb/voice"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/discorb-voice.gemspec

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "lib/discorb/voice/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "discorb-voice"
+  spec.version = Discorb::Voice::VERSION
+  spec.authors = ["sevenc-nanashi"]
+  spec.email = ["sevenc-nanashi@sevenbot.jp"]
+
+  spec.summary = "Gem for connecting voice channels with discorb."
+  spec.homepage = "https://github.com/discorb-lib/discorb-voice"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/discorb-lib/discorb-voice"
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency "discorb", ">= 0.13.0"
+  spec.add_dependency "ffi", ">= 1.15.3"
+  spec.add_dependency "rbnacl"
+
+  # For more information and examples about making a new gem, checkout our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/examples/music_bot.rb

@@ -0,0 +1,38 @@
+require "discorb"
+require "discorb/voice"
+require "open3"
+
+client = Discorb::Client.new
+
+client.once :standby do
+  puts "Logged in as #{client.user}"
+end
+
+client.slash "connect", "connect to a voice channel" do |interaction|
+  channel = interaction.target.voice_state.channel
+  interaction.post "Connecting to #{channel.name}"
+  channel.connect.wait
+  interaction.post "Connected to #{channel.name}"
+end
+
+client.slash "play", "Plays YouTube audio", {
+  "url" => {
+    type: :string,
+    description: "The URL of the YouTube video to play",
+    required: true,
+  },
+} do |interaction, url|
+  interaction.post "Querying #{url}..."
+  stdout, _status = Open3.capture2("youtube-dl", "-j", url)
+  data = JSON.parse(stdout, symbolize_names: true)
+  url = data[:formats][0][:url]
+  interaction.guild.voice_client.play(Discorb::Voice::FFmpegAudio.new(url))
+  interaction.post "Playing `#{data[:title]}`"
+end
+
+client.slash "stop", "Stops the current audio" do |interaction|
+  interaction.guild.voice_client.stop
+  interaction.post "Stopped"
+end
+
+client.run(ENV["DISCORD_BOT_TOKEN"])

data/examples/simple_player.rb

@@ -0,0 +1,25 @@
+require "discorb"
+require "discorb-voice"
+
+client.once :standby do
+  puts "Logged in as #{client.user}"
+end
+
+client.slash "connect", "connect to a voice channel" do |interaction|
+  channel = interaction.target.voice_state.channel
+  interaction.post "Connecting to #{channel.name}"
+  channel.connect.wait
+  interaction.post "Connected to #{channel.name}"
+end
+
+client.slash "play", "Plays audio" do |interaction|
+  interaction.guild.voice_client.play(Discorb::Voice::FFmpegAudio.new("./very-nice-song.mp3"))
+  interaction.post "Playing Your very nice song!"
+end
+
+client.slash "stop", "Stops the current audio" do |interaction|
+  interaction.guild.voice_client.stop
+  interaction.post "Stopped"
+end
+
+client.run(ENV["DISCORD_BOT_TOKEN"])

data/lib/discorb/voice/core.rb

@@ -0,0 +1,314 @@
+# frozen_string_literal: true
+
+require "async"
+require "async/websocket"
+require "rbnacl"
+require "socket"
+
+module Discorb
+  module Connectable
+    def connect
+      Async do
+        @client.connect_to(self).wait
+      end
+    end
+  end
+
+  module Voice
+    OPUS_SAMPLE_RATE = 48000
+    OPUS_FRAME_LENGTH = 20
+
+    class Client
+      # @private
+      attr_reader :connect_condition
+      # @return [:connecting, :connected, :closed, :ready, :reconnecting] The current status of the voice connection
+      attr_reader :status
+      # @return [:stopped, :playing] The current status of playing audio
+      attr_reader :playing_status
+      # @return [Async::Condition] The condition of playing audio
+      attr_reader :playing_condition
+
+      # @private
+      def initialize(client, data)
+        @client = client
+        @token = data[:token]
+        @guild_id = data[:guild_id]
+        @endpoint = data[:endpoint]
+        @status = :connecting
+        @playing_status = :stopped
+        @connect_condition = Async::Condition.new
+        @paused_condition = Async::Condition.new
+        @play_condition = Async::Condition.new
+        Async do
+          start_receive false
+        end
+      end
+
+      #
+      # Sends a speaking indicator to the server.
+      #
+      # @param [Boolean] high_priority Whether to send audio in high priority.
+      #
+      def speaking(high_priority: false)
+        flag = 1
+        flag |= 1 << 2 if high_priority
+        send_connection_message(5, {
+          speaking: flag,
+          delay: 0,
+          ssrc: @ssrc,
+        })
+      end
+
+      def stop_speaking
+        send_connection_message(5, {
+          speaking: false,
+          delay: 0,
+          ssrc: @ssrc,
+        })
+      end
+
+      #
+      # Plays audio from a source.
+      #
+      # @param [Discorb::Voice::Source] source data The audio source
+      # @param [Boolean] high_priority Whether to play audio in high priority
+      #
+      def play(source, high_priority: false)
+        @playing_task = Async do
+          speaking(high_priority: high_priority)
+          @playing_status = :playing
+          @playing_condition = Async::Condition.new
+          stream = OggStream.new(source.io)
+          loops = 0
+          @start_time = Time.now.to_f
+          delay = OPUS_FRAME_LENGTH / 1000.0
+
+          stream.packets.each_with_index do |packet, i|
+            @connect_condition.wait if @status == :connecting
+            if @playing_status == :stopped
+              source.cleanup
+              break
+            elsif @playing_status == :paused
+              @paused_condition.wait
+            end
+            # p i
+            @timestamp += (OPUS_SAMPLE_RATE / 1000.0 * OPUS_FRAME_LENGTH).to_i
+            @sequence += 1
+            # puts packet.data[...10].unpack1("H*")
+            # puts packet[-10..]&.unpack1("H*")
+            send_audio(packet)
+            # puts "Sent packet #{i}"
+            loops += 1
+            next_time = @start_time + (delay * (loops + 1))
+            # p [next_time, Time.now.to_f, delay]
+            sleep(next_time - Time.now.to_f) if next_time > Time.now.to_f
+            # @voice_connection.flush
+          end
+          # p :e
+          # @playing_status = :stopped
+          # @playing_condition.signal
+          # source.cleanup
+          # stop_speaking
+        end
+      end
+
+      # Note: This is commented out because it raises an error.
+      #    It's not clear why this is happening.
+      # #
+      # # Pause playing audio.
+      # #
+      # def pause
+      #   raise VoiceError, "Not playing" unless @playing_status == :playing
+      #   send_audio(OPUS_SILENCE)
+      #   @paused_condition = Async::Condition.new
+      #   @paused_offset = Time.now.to_f - @start_time
+      #   @playing_status = :paused
+      # end
+
+      # #
+      # # Resumes playing audio.
+      # #
+      # def resume
+      #   raise VoiceError, "Not paused" unless @playing_status == :paused
+      #   @paused_condition.signal
+      #   @start_time = Time.now.to_f - @paused_offset
+      # end
+
+      #
+      # Stop playing audio.
+      #
+      def stop
+        @playing_status = :stopped
+        send_audio(OPUS_SILENCE)
+      end
+
+      #
+      # Disconnects from the voice server.
+      #
+      def disconnect
+        @connection.close
+        @client.disconnect_voice(@guild_id)
+        cleanup
+      end
+
+      private
+
+      OPUS_SILENCE = [0xF8, 0xFF, 0xFE].pack("C*")
+
+      def cleanup
+        @heartbeat_task&.stop
+
+        @voice_connection&.close
+      end
+
+      def send_audio(data)
+        header = create_header
+        @voice_connection.send(
+          header + encrypt_audio(
+            data,
+            header
+          ),
+          0
+          # @sockaddr
+        )
+      rescue IOError
+        @client.log.warn("Voice connection closed")
+        @playing_task.stop if @status != :closed
+      end
+
+      def start_receive(resume)
+        Async do
+          endpoint = Async::HTTP::Endpoint.parse("wss://" + @endpoint + "?v=4", alpn_protocols: Async::HTTP::Protocol::HTTP11.names)
+          @client.log.info("Connecting to #{endpoint}")
+          Async::WebSocket::Client.connect(endpoint, handler: Discorb::Gateway::RawConnection) do |conn|
+            @connection = conn
+            @status = :connected
+            if resume
+              send_connection_message(
+                7,
+                {
+                  server_id: @guild_id,
+                  session_id: @client.session_id,
+                  token: @token,
+                }
+              )
+            else
+              send_connection_message(
+                0,
+                {
+                  server_id: @guild_id,
+                  user_id: @client.user.id,
+                  session_id: @client.session_id,
+                  token: @token,
+                }
+              )
+            end
+            while (raw_message = @connection.read)
+              message = JSON.parse(raw_message, symbolize_names: true)
+              handle_voice_connection(message)
+            end
+          rescue Async::Wrapper::Cancelled
+            @status = :closed
+            cleanup
+          rescue Errno::EPIPE
+            @status = :reconnecting
+            @connect_condition = Async::Condition.new
+            start_receive false
+          rescue Protocol::WebSocket::ClosedError => e
+            case e.code
+            when 4014
+              @status = :closed
+              cleanup
+            when 4006
+              @status = :reconnecting
+              @connect_condition = Async::Condition.new
+              start_receive false
+            when 4015, 1001, 4009
+              @status = :reconnecting
+              @connect_condition = Async::Condition.new
+              start_receive true
+            end
+          end
+        end
+      end
+
+      def handle_voice_connection(message)
+        @client.log.debug("Voice connection message: #{message}")
+        data = message[:d]
+        # pp data
+        case message[:op]
+        when 8
+          @heartbeat_task = handle_heartbeat(data[:heartbeat_interval])
+        when 2
+          @port, @ip = data[:port], data[:ip]
+          @client.log.debug("Connected to voice UDP, #{@ip}:#{@port}")
+          @sockaddr = Socket.pack_sockaddr_in(@port, @ip)
+          @voice_connection = UDPSocket.new
+          @voice_connection.connect(@ip, @port)
+          @ssrc = data[:ssrc]
+
+          @local_ip, @local_port = discover_ip.wait
+          # p @local_ip, @local_port
+          send_connection_message(1, {
+            protocol: "udp",
+            data: {
+              address: @local_ip,
+              port: @local_port,
+              mode: "xsalsa20_poly1305",
+            },
+          })
+          @sequence = 0
+          @timestamp = 0
+        when 4
+          @secret_key = data[:secret_key].pack("C*")
+          @box = RbNaCl::SecretBox.new(@secret_key)
+          @connect_condition.signal
+          @status = :ready
+        when 9
+          @connect_condition.signal
+          @status = :ready
+        end
+      end
+
+      def create_header
+        [0x80, 0x78, @sequence, @timestamp, @ssrc].pack("CCnNN").ljust(12, "\0")
+      end
+
+      def encrypt_audio(buf, nonce)
+        @box.box(nonce.ljust(24, "\0"), buf)
+      end
+
+      def discover_ip
+        Async do
+          packet = [
+            1, 70, @ssrc,
+          ].pack("S>S>I>").ljust(70, "\0")
+          @voice_connection.send(packet, 0, @sockaddr)
+          recv = @voice_connection.recv(70)
+          ip_start = 4
+          ip_end = recv.index("\0", ip_start)
+          [recv[ip_start...ip_end], recv[-2, 2].unpack1("S>")]
+        end
+      end
+
+      def handle_heartbeat(interval)
+        Async do
+          loop do
+            sleep(interval / 1000.0 * 0.9)
+            send_connection_message(3, Time.now.to_i)
+          end
+        end
+      end
+
+      def send_connection_message(op, data)
+        @connection.write(
+          {
+            op: op,
+            d: data,
+          }.to_json
+        )
+        @connection.flush
+      end
+    end
+  end
+end

data/lib/discorb/voice/error.rb

@@ -0,0 +1,7 @@
+module Discorb::Voice
+  #
+  # Error for voice connection.
+  #
+  class VoiceError < StandardError
+  end
+end

data/lib/discorb/voice/extend.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Discorb::Voice
+  # @private
+  module ClientVoicePrepend
+    attr_reader :voice_conditions
+
+    def initialize(*, **)
+      super
+      @voice_clients = Discorb::Dictionary.new
+      @voice_conditions = {}
+    end
+
+    def event_voice_server_update(data)
+      @log.debug("Received VOICE_SERVER_UPDATE")
+      client = Discorb::Voice::Client.new(self, data)
+      @voice_clients[data[:guild_id]] = client
+      client.connect_condition.wait
+      @voice_conditions[data[:guild_id]].signal client
+    end
+
+    def disconnect_voice(guild_id)
+      send_gateway(
+        4,
+        guild_id: guild_id,
+        channel_id: nil,
+
+      )
+    end
+
+    def connect_to(channel)
+      Async do
+        @log.debug("Connecting to #{channel.id}")
+        send_gateway(
+          4,
+          guild_id: channel.guild.id.to_s,
+          channel_id: channel.id.to_s,
+          self_mute: channel.guild.me.voice_state&.self_mute?,
+          self_deaf: channel.guild.me.voice_state&.self_deaf?,
+
+        )
+        condition = Async::Condition.new
+        @voice_conditions[channel.guild.id.to_s] = condition
+        condition.wait
+      end
+    end
+  end
+end
+
+class Discorb::Client
+  # @return [Discorb::Dictionary{String => Discorb::Voice::Client}] The voice clients.
+  attr_accessor :voice_clients
+
+  prepend Discorb::Voice::ClientVoicePrepend
+end
+
+class Discorb::Guild
+  # @!attribute [r] voice_client
+  #   @return [Discorb::Voice::Client] The voice client.
+  #   @return [nil] If the client is not connected to the voice server.
+  def voice_client
+    @client.voice_clients[@id.to_s]
+  end
+end

data/lib/discorb/voice/ogg.rb

@@ -0,0 +1,120 @@
+module Discorb::Voice
+  #
+  # Represents a Ogg stream.
+  #
+  class OggStream
+    #
+    # Creates a new Ogg stream.
+    #
+    # @param [IO] io The audio ogg stream.
+    #
+    def initialize(io)
+      @io = io
+    end
+
+    #
+    # Enumerates the packets of the Ogg stream.
+    #
+    # @return [Enumerator<Discorb::Voice::OggStream::Page::Packet>] The packets of the Ogg stream.
+    #
+    def packets
+      Enumerator.new do |enum|
+        part = +""
+        raw_packets.each do |packet|
+          part << packet.data
+          unless packet.partial
+            enum << part
+            part = +""
+          end
+        end
+      end
+    end
+
+    #
+    # Enumerates the raw packets of the Ogg stream.
+    # This may include partial packets.
+    #
+    # @return [Enumerator<Discorb::Voice::OggStream::Page::Packet>] The raw packets of the Ogg stream.
+    #
+    def raw_packets
+      Enumerator.new do |enum|
+        loop do
+          # p c += 1
+          if @io.read(4) != "OggS"
+            break
+          end
+          pg = Page.new(@io)
+          pg.packets.each do |packet|
+            enum << packet
+          end
+          # enum << pg.packets.next
+        end
+      end
+    end
+
+    #
+    # Represents a page of the Ogg stream.
+    #
+    class Page
+      # @return [Struct] The struct of the packet
+      Packet = Struct.new(:data, :partial, :page)
+      # @return [Integer] The version of the page.
+      attr_reader :version
+      # @return [Integer] The header type of the page.
+      attr_reader :header_type
+      # @return [Integer] The granule position of the page.
+      attr_reader :granule_position
+      # @return [Integer] The bitstream serial number of the page.
+      attr_reader :bitstream_serial_number
+      # @return [Integer] The page sequence number of the page.
+      attr_reader :page_sequence_number
+      # @return [Integer] The CRC checksum of the page.
+      attr_reader :crc_checksum
+      # @return [Integer] The length of the page segment table.
+      attr_reader :page_segments
+      # @return [String] The body of the page.
+      attr_reader :body
+
+      #
+      # Creates a new page.
+      #
+      # @param [IO] io The audio ogg stream.
+      # @note This method will seek the io.
+      #
+      def initialize(io)
+        @version, @header_type, @granule_position, @bitstream_serial_number, @page_sequence_number, @crc_checksum, @page_segments =
+          io.read(23).unpack("CCQ<L<L<L<C")
+        @segtable = io.read(@page_segments)
+        len = @segtable.unpack("C*").sum
+        @body = io.read(len)
+      end
+
+      #
+      # Enumerates the packets of the page.
+      #
+      # @return [Enumerator<Discorb::Voice::OggStream::Page::Packet>] The packets of the page.
+      #
+      def packets
+        Enumerator.new do |enum|
+          offset = 0
+          length = 0
+          partial = true
+          @segtable.bytes.each do |seg|
+            if seg == 255
+              length += 255
+              partial = true
+            else
+              length += seg
+              partial = false
+              enum << Packet.new(@body[offset, length], partial, self)
+              offset += length
+              length = 0
+            end
+          end
+
+          enum << Packet.new(@body[offset, length], partial, self) if partial
+        end
+      end
+    end
+  end
+end

data/lib/discorb/voice/source.rb

@@ -0,0 +1,110 @@
+require "open3"
+require "tmpdir"
+
+module Discorb::Voice
+  #
+  # The source of audio data.
+  # @abstract
+  #
+  class Source
+    #
+    # The audio ogg stream. This MUST be implemented by subclasses.
+    #
+    # @return [#read] The audio ogg stream.
+    #
+    def io
+      raise NotImplementedError
+    end
+
+    #
+    # Clean up the source.
+    # This does nothing by default.
+    #
+    def cleanup
+      # noop
+    end
+  end
+
+  #
+  # Plays audio from a source, using FFmpeg.
+  # @note You must install FFmpeg and should be on the PATH.
+  #
+  class FFmpegAudio
+    attr_reader :stdin, :stdout, :stderr, :process
+
+    #
+    # Creates a new FFmpegAudio.
+    #
+    # @param [String, IO] source The source of audio data.
+    # @param [Integer] bitrate The bitrate of the audio.
+    # @param [{String => String}] extra_options Extra options for FFmpeg. This will be passed before `-i`.
+    # @param [{String => String}] extra_options2 Extra options for FFmpeg. This will be passed after `-i`.
+    #
+    def initialize(source, bitrate: 128, extra_options: {}, extra_options2: {})
+      if source.is_a?(String)
+        source_path = source
+        @tmp_path = nil
+      else
+        source_path = "#{Dir.tmpdir}/#{Process.pid}.#{source.object_id}"
+        @tmp_path = source_path
+        File.open(source_path, "wb") do |f|
+          while chunk = source.read(4096)
+            f.write(chunk)
+          end
+        end
+      end
+      args = %W[ffmpeg]
+      extra_options.each do |key, value|
+        args += ["-#{key}", "#{value}"]
+      end
+      args += %W[
+        -i #{source_path}
+        -f opus
+        -c:a libopus
+        -ar 48000
+        -ac 2
+        -b:a #{bitrate}k
+        -loglevel warning
+        -map_metadata -1]
+      extra_options2.each do |key, value|
+        args += ["-#{key}", "#{value}"]
+      end
+      args += %w[pipe:1]
+      @stdin, @stdout, @process = Open3.popen2(*args)
+    end
+
+    def io
+      @stdout
+    end
+
+    #
+    # Kills the FFmpeg process.
+    #
+    def cleanup
+      @process.kill
+      if @tmp_path
+        File.delete(@tmp_path)
+      end
+    end
+  end
+
+  #
+  # Plays audio from a ogg file.
+  #
+  class OggAudio
+    attr_reader :io
+
+    #
+    # Opens an ogg file.
+    #
+    # @param [String, IO] src The ogg file to open, or an IO object.
+    #
+    def initialize(src)
+      if src.is_a?(String)
+        @io = File.open(src, "rb")
+      else
+        @io = src
+      end
+    end
+  end
+end

data/lib/discorb/voice/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Discorb
+  module Voice
+    # @return [String] The version of the library.
+    VERSION = "0.1.0"
+  end
+end

data/lib/discorb/voice.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "discorb"
+begin
+  require "rbnacl"
+rescue LoadError
+  raise LoadError, <<~EOS, cause: nil
+                             Could not load libsodium library.
+                             Follow the instructions at https://github.com/discorb-lib/discorb-voice#install-libsodium
+                           EOS
+end
+require "open3"
+begin
+  ffmpeg_version = Open3.capture2e("ffmpeg -version")[0]
+rescue Errno::ENOENT
+  raise LoadError, <<~EOS, cause: nil
+                             Could not find ffmpeg.
+                             Follow the instructions at https://github.com/discorb-lib/discorb-voice#install-ffmpeg
+                           EOS
+else
+  line = ffmpeg_version.split("\n").find { |line| line.start_with?("configuration: ") }
+  unless line.include? "--enable-libopus"
+    raise LoadError, <<~EOS, cause: nil
+                               Your ffmpeg version does not support opus.
+                               Install ffmpeg with opus support.
+                             EOS
+  end
+end
+require_relative "voice/version"
+require_relative "voice/extend"
+require_relative "voice/core"
+require_relative "voice/ogg"
+require_relative "voice/source"
+
+module Discorb
+  module Voice
+    class Error < StandardError; end
+  end
+end

data/lib/discorb-voice.rb

@@ -0,0 +1 @@
+require "discorb/voice"

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: discorb-voice
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- sevenc-nanashi
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-12-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: discorb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.13.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.13.0
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.15.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.15.3
+- !ruby/object:Gem::Dependency
+  name: rbnacl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email:
+- sevenc-nanashi@sevenbot.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- discorb-voice.gemspec
+- examples/music_bot.rb
+- examples/simple_player.rb
+- lib/discorb-voice.rb
+- lib/discorb/voice.rb
+- lib/discorb/voice/core.rb
+- lib/discorb/voice/error.rb
+- lib/discorb/voice/extend.rb
+- lib/discorb/voice/ogg.rb
+- lib/discorb/voice/source.rb
+- lib/discorb/voice/version.rb
+homepage: https://github.com/discorb-lib/discorb-voice
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/discorb-lib/discorb-voice
+  source_code_uri: https://github.com/discorb-lib/discorb-voice
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.32
+signing_key:
+specification_version: 4
+summary: Gem for connecting voice channels with discorb.
+test_files: []