agora_rails 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 04a40ffed9d5e20f48386decfc354bc5fe3883a50ab12931a91770cce0f7caeb
+  data.tar.gz: 27875a1500f997aff4d662c2291037eee9f2a7502563d43ee9580959635b91d0
+SHA512:
+  metadata.gz: '077592d3284b50e15f8487cd3ddb310494c0e09cb67eb95f19153dffac3a41378d34c0eb98ad5ac9e9e7c372c5a58892113c51b4c1c993174c7d7c949ad2fa13'
+  data.tar.gz: c588ebe7535c4a88ff6493c4efaa29ded72a11de2e65b15672bc6e5047863d4c7500cf0dbecd82f4b2d0168085462cab867cb6b819bfb6634753ad1aa7a81ee4

data/README.md

@@ -0,0 +1,91 @@
+# AgoraRails
+
+AgoraRails is a Ruby gem that provides an interface for Agora.io APIs, specifically designed for Ruby on Rails. It offers functionality for generating dynamic tokens and managing cloud recording.
+
+## Installation
+
+Add this line to your application's Gemfile:
+```ruby
+gem 'agora_rails'
+```
+
+And then execute:
+```
+$ bundle install
+```
+
+## Configuration
+
+Create an initializer file (e.g., `config/initializers/agora_rails.rb`) and add your Agora.io credentials:
+
+```ruby
+AgoraRails.configure do |config|
+  config.app_id = 'your_app_id'
+  config.app_certificate = 'your_app_certificate'
+  config.customer_id = 'your_customer_id'
+  config.customer_secret = 'your_customer_secret'
+
+  config.bucket = 'your_bucket'
+  config.access_key = 'your_access_key'
+  config.secret_key = 'your_secret_key'
+  config.file_prefix = 'your_file_prefix'
+end
+```
+
+The `file_prefix` is optional and is used to store the recording files in a specific folder in your bucket. For example, if you set the file_prefix to `["agora", "calls", "v3"]`, the recording files will be stored in a folder `agora/calls/v3` in your bucket.
+
+
+## Usage
+
+### Token Generation
+
+The token generator is taken from the [Agora Tools repo](https://github.com/AgoraIO/Tools) and uses DynamicKey2.
+DynamicKey2 requires `uid` to be an integer (i.e. not a string).
+
+Generate a token for a specific channel and user:
+
+```ruby
+channel_name = 'my_channel'
+uid = 1234
+
+recorder = AgoraRails::CloudRecording.new
+token = recorder.generate_token(channel_name, uid)
+```
+You can validate the token at https://api-agora.solutions/
+
+
+### Cloud Recording
+
+Start cloud recording for a channel:
+
+```ruby
+channel_name = 'my_channel'
+uid = 1234
+recorder = AgoraRails::CloudRecording.new
+recorder.start(channel_name, uid)
+```
+
+Stop cloud recording for a channel:
+
+If you have the CloudRecording object, you can use it to stop the recording:
+
+```ruby
+recorder.stop
+```
+
+If you don't have the CloudRecording object, you can use the following method to stop the recording:
+
+```ruby
+recorder = AgoraRails::CloudRecording.new
+recorder.stop(channel_name, sid, uid, mode)
+
+```
+
+
+## Development
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+#### Speech-to-Text (STT)
+
+STT support is currently being worked on.

data/lib/agora_rails/cloud_recording.rb

@@ -0,0 +1,131 @@
+require 'dynamic_key2'
+require 'httparty'
+
+module AgoraRails
+  class CloudRecording
+    include HTTParty
+    base_uri 'https://api.agora.io/v1/apps'
+    
+    debug_output $stdout # uncomment this for debugging i.e. output to stdout
+
+    attr_accessor :app_id, :app_certificate, :customer_key, :customer_secret, :auth, :resource_id, :uid, :bucket, :access_key, :secret_key, :sid, :channel_name, :mode
+
+    def initialize
+      self.app_id = AgoraRails.configuration.app_id
+      self.app_certificate = AgoraRails.configuration.app_certificate
+      self.customer_key = AgoraRails.configuration.customer_key
+      self.customer_secret = AgoraRails.configuration.customer_secret
+      self.auth = { username: customer_key, password: customer_secret }
+      self.uid = "#{rand(2_000_000_000..3_000_000_000)}"
+      self.mode = 'mix'
+    end
+
+    def acquire_resource(channel_name, uid = nil)
+      self.channel_name = channel_name
+      self.uid = uid if uid
+      response = self.class.post("/#{app_id}/cloud_recording/acquire",
+        basic_auth: auth,
+        headers: { 'Content-Type' => 'application/json' },
+        body: {
+          cname: channel_name,
+          uid: self.uid.to_s,
+          clientRequest: { resourceExpiredHour: 24 }
+        }.to_json
+      )
+      self.resource_id = handle_response(response)['resourceId']
+    end
+
+    def start(channel_name, uid = nil, mode = nil, recording_config = nil)
+      raise "Invalid Channel Name" if channel_name.nil?
+      self.channel_name = channel_name
+      self.uid = uid if uid
+      self.mode = mode if mode
+      acquire_resource(channel_name)
+      recording_config ||= default_recording_config(channel_name, self.uid)
+      
+      response = self.class.post("/#{app_id}/cloud_recording/resourceid/#{resource_id}/mode/#{self.mode}/start",
+        basic_auth: auth,
+        headers: { 'Content-Type' => 'application/json' },
+        body: recording_config.to_json
+      )
+      self.sid = handle_response(response)['sid']
+    end
+
+    def stop(channel_name = nil, sid = nil, uid = nil, mode = nil)
+      raise "Invalid Channel Name" if channel_name.nil? && self.channel_name.nil?
+      raise "Invalid SID" if sid.nil? && self.sid.nil?
+      self.channel_name = channel_name if channel_name
+      self.sid = sid if sid
+      self.uid = uid if uid
+      self.mode = mode if mode
+
+      acquire_resource(self.channel_name) if self.resource_id.nil? # FIXME: should pass resource_id in because it is possible that the resource ID is expired or acquired for another channel
+
+      response = self.class.post("/#{app_id}/cloud_recording/resourceid/#{self.resource_id}/sid/#{self.sid}/mode/#{self.mode}/stop",
+        basic_auth: auth,
+        headers: { 'Content-Type' => 'application/json' },
+        body: {
+          cname: self.channel_name,
+          uid: self.uid.to_s,
+          clientRequest: {}
+        }.to_json
+      )
+      handle_response(response)
+    end
+
+    def query(channel_name = nil)
+      self.channel_name = channel_name if channel_name
+      response = self.class.get("/#{app_id}/cloud_recording/resourceid/#{self.resource_id}/sid/#{self.sid}/mode/#{mode}/query",
+        basic_auth: auth,
+        headers: { 'Content-Type' => 'application/json' },
+      )
+      handle_response(response)
+    end
+
+
+    def generate_token(channel_name = nil, uid = nil)
+      self.channel_name = channel_name if channel_name
+      self.uid = uid if uid
+
+      token_expiration_in_seconds = 3600 # 1 hour
+      privilege_expiration_in_seconds = 3600 # 1 hour
+      ::AgoraDynamicKey2::RtcTokenBuilder.build_token_with_uid(
+        app_id, app_certificate, self.channel_name, self.uid,
+        ::AgoraDynamicKey2::RtcTokenBuilder::ROLE_PUBLISHER, token_expiration_in_seconds, privilege_expiration_in_seconds
+      )
+    end
+
+    private
+
+    def handle_response(response)
+      if response.success?
+        JSON.parse(response.body)
+      else
+        raise AgoraRails::Error, "API request failed: #{response.code} - #{response.body}"
+      end
+    end
+
+    def default_recording_config(channel_name, uid)
+      {
+        cname: channel_name,
+        uid: uid.to_s,
+        clientRequest: {
+          token: generate_token,
+          recordingConfig: {
+            maxIdleTime: 30,
+            streamTypes: 0, # 0: audio only, 1: audio and video, 2: video only
+            channelType: 0, # 0: communication (audio call / video call), 1: live-broadcast (video live streaming)
+          },
+          storageConfig: {
+            vendor: 1, # 1: AWS, 2: Azure, 3: GCP, 4: Aliyun, 5: Tencent, 6: Qiniu, 7: AWS_S3, 8: Azure_Blob, 9: GCP_Storage, 10: Aliyun_OSS, 11: Tencent_COS, 12: Qiniu_Kodo
+            region: 0, # 0: us-east-1, 1: us-east-2
+            bucket: AgoraRails.configuration.bucket,
+            accessKey: AgoraRails.configuration.access_key,
+            secretKey: AgoraRails.configuration.secret_key,
+            fileNamePrefix: AgoraRails.configuration.file_prefix,
+          },
+        },
+      }
+    end
+  end
+end

data/lib/agora_rails/configuration.rb

@@ -0,0 +1,16 @@
+module AgoraRails
+  class Configuration
+    attr_accessor :app_id, :app_certificate, :customer_key, :customer_secret, :bucket, :access_key, :secret_key, :file_prefix
+
+    def initialize
+      @app_id = nil
+      @app_certificate = nil
+      @customer_key = nil
+      @customer_secret = nil
+      @bucket = nil
+      @access_key = nil
+      @secret_key = nil
+      @file_prefix = nil
+    end
+  end
+end

data/lib/agora_rails/stt.rb

@@ -0,0 +1,46 @@
+require 'httparty'
+
+module AgoraRails
+  class STT
+    include HTTParty
+    base_uri 'https://api.agora.io/v1/projects'
+
+    def initialize
+      @app_id = AgoraRails.configuration.app_id
+      @customer_key = AgoraRails.configuration.customer_key
+      @customer_secret = AgoraRails.configuration.customer_secret
+      @auth = { username: @customer_key, password: @customer_secret }
+    end
+
+    def start_task(channel_name, uid, config)
+      response = self.class.post("/#{@app_id}/rtsc/speech-to-text/tasks",
+        basic_auth: @auth,
+        headers: { 'Content-Type' => 'application/json' },
+        body: {
+          channel_name: channel_name,
+          uid: uid.to_s,
+          config: config
+        }.to_json
+      )
+      handle_response(response)
+    end
+
+    def stop_task(task_id)
+      response = self.class.delete("/#{@app_id}/rtsc/speech-to-text/tasks/#{task_id}",
+        basic_auth: @auth,
+        headers: { 'Content-Type' => 'application/json' }
+      )
+      handle_response(response)
+    end
+
+    private
+
+    def handle_response(response)
+      if response.success?
+        JSON.parse(response.body)
+      else
+        raise AgoraRails::Error, "API request failed: #{response.code} - #{response.body}"
+      end
+    end
+  end
+end

data/lib/agora_rails.rb

@@ -0,0 +1,16 @@
+require_relative "agora_rails/configuration"
+require_relative "agora_rails/cloud_recording"
+require_relative "agora_rails/stt"
+
+module AgoraRails
+  class Error < StandardError; end
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration)
+  end
+end

data/lib/dynamic_key2/access_token.rb

@@ -0,0 +1,220 @@
+require 'openssl'
+require 'zlib'
+require 'base64'
+
+module AgoraDynamicKey2
+  class Service
+    attr_accessor :type, :privileges
+
+    def initialize(type)
+      @type = type
+      @privileges = {}
+    end
+
+    def add_privilege(privilege, expire)
+      @privileges[privilege] = expire
+    end
+
+    def fetch_uid(uid)
+      return '' if uid.eql?(0)
+
+      uid.to_s
+    end
+
+    def pack
+      Util.pack_uint16(@type) + Util.pack_map_uint32(@privileges)
+    end
+
+    def unpack(data)
+      @privileges, data = Util.unpack_map_uint32(data)
+    end
+  end
+
+  class ServiceRtc < Service
+    attr_accessor :channel_name, :uid
+
+    SERVICE_TYPE = 1
+    PRIVILEGE_JOIN_CHANNEL = 1
+    PRIVILEGE_PUBLISH_AUDIO_STREAM = 2
+    PRIVILEGE_PUBLISH_VIDEO_STREAM = 3
+    PRIVILEGE_PUBLISH_DATA_STREAM = 4
+
+    def initialize(channel_name = '', uid = '')
+      super(SERVICE_TYPE)
+      @channel_name = channel_name
+      @uid = fetch_uid(uid)
+    end
+
+    def pack
+      super() + Util.pack_string(@channel_name) + Util.pack_string(@uid)
+    end
+
+    def unpack(data)
+      _, data = super(data)
+      @channel_name, data = Util.unpack_string(data)
+      @uid, data = Util.unpack_string(data)
+    end
+  end
+
+  class ServiceRtm < Service
+    attr_accessor :user_id
+
+    SERVICE_TYPE = 2
+    PRIVILEGE_JOIN_LOGIN = 1
+
+    def initialize(user_id = '')
+      super(SERVICE_TYPE)
+      @user_id = user_id
+    end
+
+    def pack
+      super() + Util.pack_string(@user_id)
+    end
+
+    def unpack(data)
+      _, data = super(data)
+      @user_id, data = Util.unpack_string(data)
+    end
+  end
+
+  class ServiceFpa < Service
+    SERVICE_TYPE = 4
+    PRIVILEGE_LOGIN = 1
+
+    def initialize
+      super(SERVICE_TYPE)
+    end
+
+    def pack
+      super()
+    end
+
+    def unpack(data)
+      _, data = super(data)
+    end
+  end
+
+  class ServiceChat < Service
+    attr_accessor :uid
+
+    SERVICE_TYPE = 5
+    PRIVILEGE_USER = 1
+    PRIVILEGE_APP = 2
+
+    def initialize(uid = '')
+      super(SERVICE_TYPE)
+      @uid = fetch_uid(uid)
+    end
+
+    def pack
+      super() + Util.pack_string(@uid)
+    end
+
+    def unpack(data)
+      _, data = super(data)
+      @uid, data = Util.unpack_string(data)
+    end
+  end
+
+  class ServiceApaas < Service
+    attr_accessor :room_uuid, :user_uuid, :role
+
+    SERVICE_TYPE = 7
+    PRIVILEGE_ROOM_USER = 1
+    PRIVILEGE_USER = 2
+    PRIVILEGE_APP = 3
+
+    def initialize(room_uuid = '', user_uuid = '', role = -1)
+      super(SERVICE_TYPE)
+      @room_uuid = room_uuid
+      @user_uuid = user_uuid
+      @role = role
+    end
+
+    def pack
+      super() + Util.pack_string(@room_uuid) + Util.pack_string(@user_uuid) + Util.pack_int16(@role)
+    end
+
+    def unpack(data)
+      _, data = super(data)
+      @room_uuid, data = Util.unpack_string(data)
+      @user_uuid, data = Util.unpack_string(data)
+      @role, data = Util.unpack_int16(data)
+    end
+  end
+
+  class AccessToken
+    attr_accessor :app_cert, :app_id, :expire, :issue_ts, :salt, :services
+
+    VERSION = '007'.freeze
+    VERSION_LENGTH = 3
+    SERVICES = { ServiceRtc::SERVICE_TYPE => ServiceRtc,
+                 ServiceRtm::SERVICE_TYPE => ServiceRtm,
+                 ServiceFpa::SERVICE_TYPE => ServiceFpa,
+                 ServiceChat::SERVICE_TYPE => ServiceChat,
+                 ServiceApaas::SERVICE_TYPE => ServiceApaas }.freeze
+
+    def initialize(app_id = '', app_cert = '', expire = 900)
+      @app_id = app_id
+      @app_cert = app_cert
+      @expire = expire
+      @issue_ts = Time.now.to_i
+      @salt = rand(1...99_999_999)
+      @services = {}
+    end
+
+    def add_service(service)
+      @services[service.type] = service
+    end
+
+    def build
+      return '' if !uuid?(@app_id) || !uuid?(@app_cert)
+
+      signing = fetch_sign
+      data = Util.pack_string(@app_id) + Util.pack_uint32(@issue_ts) + Util.pack_uint32(@expire) \
+                   + Util.pack_uint32(@salt) + Util.pack_uint16(@services.size)
+
+      @services.each do |_, service|
+        data += service.pack
+      end
+
+      signature = OpenSSL::HMAC.digest(OpenSSL::Digest.new('sha256'), signing, data)
+      fetch_version + Base64.strict_encode64(Zlib::Deflate.deflate(Util.pack_string(signature) + data))
+    end
+
+    def fetch_sign
+      sign = OpenSSL::HMAC.digest(OpenSSL::Digest.new('sha256'), Util.pack_uint32(@issue_ts), @app_cert)
+      OpenSSL::HMAC.digest(OpenSSL::Digest.new('sha256'), Util.pack_uint32(@salt), sign)
+    end
+
+    def fetch_version
+      VERSION
+    end
+
+    def uuid?(str)
+      return false if str.length != 32
+
+      true
+    end
+
+    def parse(token)
+      return false if token[0..VERSION_LENGTH - 1] != fetch_version
+
+      data = Zlib::Inflate.inflate(Base64.strict_decode64(token[VERSION_LENGTH..-1]))
+      signature, data = Util.unpack_string(data)
+      @app_id, data = Util.unpack_string(data)
+      @issue_ts, data = Util.unpack_uint32(data)
+      @expire, data = Util.unpack_uint32(data)
+      @salt, data = Util.unpack_uint32(data)
+      service_num, data = Util.unpack_uint16(data)
+
+      (1..service_num).each do
+        service_type, data = Util.unpack_uint16(data)
+        service = SERVICES[service_type].new
+        _, data = service.unpack(data)
+        @services[service_type] = service
+      end
+      true
+    end
+  end
+end

data/lib/dynamic_key2/apaas_token_builder.rb

@@ -0,0 +1,73 @@
+module AgoraDynamicKey2
+  class ApaasTokenBuilder
+    # Build room user token.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # room_uuid: The room's id, must be unique.
+    # user_uuid: The user's id, must be unique.
+    # role: The user's role.
+    # expire: represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #     Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # return: The room user token.
+    def self.build_room_user_token(app_id, app_certificate, room_uuid, user_uuid, role, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      chat_user_id = Digest::MD5.hexdigest user_uuid
+      service_apaas = AgoraDynamicKey2::ServiceApaas.new(room_uuid, user_uuid, role)
+      service_apaas.add_privilege(AgoraDynamicKey2::ServiceApaas::PRIVILEGE_ROOM_USER, expire)
+      access_token.add_service(service_apaas)
+
+      service_rtm = AgoraDynamicKey2::ServiceRtm.new(user_uuid)
+      service_rtm.add_privilege(AgoraDynamicKey2::ServiceRtm::PRIVILEGE_JOIN_LOGIN, expire)
+      access_token.add_service(service_rtm)
+
+      service_chat = AgoraDynamicKey2::ServiceChat.new(chat_user_id)
+      service_chat.add_privilege(AgoraDynamicKey2::ServiceChat::PRIVILEGE_USER, expire)
+      access_token.add_service(service_chat)
+
+      access_token.build
+    end
+
+    # Build user token.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # user_uuid: The user's id, must be unique.
+    # expire: represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #     Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # return: The user token.
+    def self.build_user_token(app_id, app_certificate, user_uuid, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      service_apaas = AgoraDynamicKey2::ServiceApaas.new('', user_uuid)
+      service_apaas.add_privilege(AgoraDynamicKey2::ServiceApaas::PRIVILEGE_USER, expire)
+      access_token.add_service(service_apaas)
+
+      access_token.build
+    end
+
+    # Build app token.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # expire: represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #     Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # return: The app token.
+    def self.build_app_token(app_id, app_certificate, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      service_apaas = AgoraDynamicKey2::ServiceApaas.new
+      service_apaas.add_privilege(AgoraDynamicKey2::ServiceApaas::PRIVILEGE_APP, expire)
+      access_token.add_service(service_apaas)
+
+      access_token.build
+    end
+  end
+end

data/lib/dynamic_key2/chat_token_builder.rb

@@ -0,0 +1,42 @@
+module AgoraDynamicKey2
+  class ChatTokenBuilder
+    # Build the Chat user token.
+    #
+    # @param app_id:          The App ID issued to you by Agora. Apply for a new App ID from
+    #                         Agora Dashboard if it is missing from your kit. See Get an App ID.
+    # @param app_certificate: Certificate of the application that you registered in
+    #                         the Agora Dashboard. See Get an App Certificate.
+    # @param user_id:         The user's account, max length is 64 Bytes.
+    # @param expire:          represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #                         Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # @return The Chat User token.
+    def self.build_user_token(app_id, app_certificate, user_id, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      service_chat = AgoraDynamicKey2::ServiceChat.new(user_id)
+      service_chat.add_privilege(AgoraDynamicKey2::ServiceChat::PRIVILEGE_USER, expire)
+      access_token.add_service(service_chat)
+
+      access_token.build
+    end
+
+    # Build the Chat App token.
+    #
+    # @param app_id:          The App ID issued to you by Agora. Apply for a new App ID from
+    #                         Agora Dashboard if it is missing from your kit. See Get an App ID.
+    # @param app_certificate: Certificate of the application that you registered in
+    #                         the Agora Dashboard. See Get an App Certificate.
+    # @param expire:          represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #                         Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # @return The Chat App token.
+    def self.build_app_token(app_id, app_certificate, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      service_chat = AgoraDynamicKey2::ServiceChat.new
+      service_chat.add_privilege(AgoraDynamicKey2::ServiceChat::PRIVILEGE_APP, expire)
+      access_token.add_service(service_chat)
+
+      access_token.build
+    end
+  end
+end

data/lib/dynamic_key2/education_token_builder.rb

@@ -0,0 +1,73 @@
+module AgoraDynamicKey2
+  class EducationTokenBuilder
+    # Build room user token.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # room_uuid: The room's id, must be unique.
+    # user_uuid: The user's id, must be unique.
+    # role: The user's role.
+    # expire: represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #     Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # return: The room user token.
+    def self.build_room_user_token(app_id, app_certificate, room_uuid, user_uuid, role, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      chat_user_id = Digest::MD5.hexdigest user_uuid
+      service_apaas = AgoraDynamicKey2::ServiceApaas.new(room_uuid, user_uuid, role)
+      service_apaas.add_privilege(AgoraDynamicKey2::ServiceApaas::PRIVILEGE_ROOM_USER, expire)
+      access_token.add_service(service_apaas)
+
+      service_rtm = AgoraDynamicKey2::ServiceRtm.new(user_uuid)
+      service_rtm.add_privilege(AgoraDynamicKey2::ServiceRtm::PRIVILEGE_JOIN_LOGIN, expire)
+      access_token.add_service(service_rtm)
+
+      service_chat = AgoraDynamicKey2::ServiceChat.new(chat_user_id)
+      service_chat.add_privilege(AgoraDynamicKey2::ServiceChat::PRIVILEGE_USER, expire)
+      access_token.add_service(service_chat)
+
+      access_token.build
+    end
+
+    # Build user token.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # user_uuid: The user's id, must be unique.
+    # expire: represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #     Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # return: The user token.
+    def self.build_user_token(app_id, app_certificate, user_uuid, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      service_apaas = AgoraDynamicKey2::ServiceApaas.new('', user_uuid)
+      service_apaas.add_privilege(AgoraDynamicKey2::ServiceApaas::PRIVILEGE_USER, expire)
+      access_token.add_service(service_apaas)
+
+      access_token.build
+    end
+
+    # Build app token.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # expire: represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #     Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # return: The app token.
+    def self.build_app_token(app_id, app_certificate, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+
+      service_apaas = AgoraDynamicKey2::ServiceApaas.new
+      service_apaas.add_privilege(AgoraDynamicKey2::ServiceApaas::PRIVILEGE_APP, expire)
+      access_token.add_service(service_apaas)
+
+      access_token.build
+    end
+  end
+end

data/lib/dynamic_key2/fpa_token_builder.rb

@@ -0,0 +1,20 @@
+module AgoraDynamicKey2
+  class FpaTokenBuilder
+    # Build the FPA token.
+    #
+    # @param app_id The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    # from your kit. See Get an App ID.
+    # @param app_certificate Certificate of the application that you registered in the Agora Dashboard.
+    # See Get an App Certificate.
+    # @return The FPA token.
+    def self.build_token(app_id, app_certificate)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, 24 * 3600)
+
+      service_fpa = AgoraDynamicKey2::ServiceFpa.new
+      service_fpa.add_privilege(AgoraDynamicKey2::ServiceFpa::PRIVILEGE_LOGIN, 0)
+      access_token.add_service(service_fpa)
+
+      access_token.build
+    end
+  end
+end

data/lib/dynamic_key2/rtc_token_builder.rb

@@ -0,0 +1,215 @@
+module AgoraDynamicKey2
+  class RtcTokenBuilder
+    # RECOMMENDED. Use this role for a voice/video call or a live broadcast, if
+    # your scenario does not require authentication for
+    # [Co-host](https://docs.agora.io/en/video-calling/get-started/authentication-workflow?#co-host-token-authentication).
+    ROLE_PUBLISHER = 1
+
+    # Only use this role if your scenario require authentication for
+    # [Co-host](https://docs.agora.io/en/video-calling/get-started/authentication-workflow?#co-host-token-authentication).
+    # @note In order for this role to take effect, please contact our support team
+    # to enable authentication for Hosting-in for you. Otherwise, Role_Subscriber
+    # still has the same privileges as Role_Publisher.
+    ROLE_SUBSCRIBER = 2
+
+    # Build the RTC token with uid.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # channel_name: Unique channel name for the AgoraRTC session in the string format.
+    # uid: User ID. A 32-bit unsigned integer with a value ranging from 1 to (2^32-1).
+    #     uid must be unique.
+    # role: ROLE_PUBLISHER: A broadcaster/host in a live-broadcast profile.
+    #     ROLE_SUBSCRIBER: An audience(default) in a live-broadcast profile.
+    # token_expire: represented by the number of seconds elapsed since now. If, for example,
+    #    you want to access the Agora Service within 10 minutes after the token is generated,
+    #    set token_expire as 600(seconds).
+    # privilege_expire: represented by the number of seconds elapsed since now. If, for example,
+    #    you want to enable your privilege for 10 minutes, set privilege_expire as 600(seconds).
+    # return: The RTC token.
+    def self.build_token_with_uid(app_id, app_certificate, channel_name, uid, role, token_expire, privilege_expire = 0)
+      build_token_with_user_account(app_id, app_certificate, channel_name, uid, role, token_expire, privilege_expire)
+    end
+
+    # Build the RTC token with account.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # channel_name: Unique channel name for the AgoraRTC session in the string format.
+    # uid: User ID. A 32-bit unsigned integer with a value ranging from 1 to (2^32-1).
+    #     uid must be unique.
+    # role: ROLE_PUBLISHER: A broadcaster/host in a live-broadcast profile.
+    #     ROLE_SUBSCRIBER: An audience(default) in a live-broadcast profile.
+    # token_expire: represented by the number of seconds elapsed since now. If, for example,
+    #    you want to access the Agora Service within 10 minutes after the token is generated,
+    #    set token_expire as 600(seconds).
+    # privilege_expire: represented by the number of seconds elapsed since now. If, for example,
+    #    you want to enable your privilege for 10 minutes, set privilege_expire as 600(seconds).
+    # return: The RTC token.
+    def self.build_token_with_user_account(app_id, app_certificate, channel_name, account, role, token_expire, privilege_expire = 0)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, token_expire)
+      service_rtc = AgoraDynamicKey2::ServiceRtc.new(channel_name, account)
+
+      service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_JOIN_CHANNEL, privilege_expire)
+      if role == ROLE_PUBLISHER
+        service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_AUDIO_STREAM, privilege_expire)
+        service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_VIDEO_STREAM, privilege_expire)
+        service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_DATA_STREAM, privilege_expire)
+      end
+      access_token.add_service(service_rtc)
+      access_token.build
+    end
+
+    # Generates an RTC token with the specified privilege.
+    #
+    # This method supports generating a token with the following privileges:
+    # - Joining an RTC channel.
+    # - Publishing audio in an RTC channel.
+    # - Publishing video in an RTC channel.
+    # - Publishing data streams in an RTC channel.
+    #
+    # The privileges for publishing audio, video, and data streams in an RTC channel apply only if you have
+    # enabled co-host authentication.
+    #
+    # A user can have multiple privileges. Each privilege is valid for a maximum of 24 hours.
+    # The SDK triggers the onTokenPrivilegeWillExpire and onRequestToken callbacks when the token is about to expire
+    # or has expired. The callbacks do not report the specific privilege affected, and you need to maintain
+    # the respective timestamp for each privilege in your app logic. After receiving the callback, you need
+    # to generate a new token, and then call renewToken to pass the new token to the SDK, or call joinChannel to re-join
+    # the channel.
+    #
+    # @note
+    # Agora recommends setting a reasonable timestamp for each privilege according to your scenario.
+    # Suppose the expiration timestamp for joining the channel is set earlier than that for publishing audio.
+    # When the token for joining the channel expires, the user is immediately kicked off the RTC channel
+    # and cannot publish any audio stream, even though the timestamp for publishing audio has not expired.
+    #
+    # @param app_id The App ID of your Agora project.
+    # @param app_certificate The App Certificate of your Agora project.
+    # @param channel_name The unique channel name for the Agora RTC session in string format. The string length must be less than 64 bytes. The channel name may contain the following characters:
+    # - All lowercase English letters: a to z.
+    # - All uppercase English letters: A to Z.
+    # - All numeric characters: 0 to 9.
+    # - The space character.
+    # - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",".
+    # @param uid The user ID. A 32-bit unsigned integer with a value range from 1 to (2^32 - 1). It must be unique. Set uid as 0, if you do not want to authenticate the user ID, that is, any uid from the app client can join the channel.
+    # @param token_expire represented by the number of seconds elapsed since now. If, for example, you want to access the
+    # Agora Service within 10 minutes after the token is generated, set token_expire as 600(seconds).
+    # @param join_channel_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to join channel and expect stay in the channel for 10 minutes, set join_channel_privilege_expire as 600(seconds).
+    # @param pub_audio_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to enable publish audio privilege for 10 minutes, set pub_audio_privilege_expire as 600(seconds).
+    # @param pub_video_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to enable publish video privilege for 10 minutes, set pub_video_privilege_expire as 600(seconds).
+    # @param pub_data_stream_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to enable publish data stream privilege for 10 minutes, set pub_data_stream_privilege_expire as 600(seconds).
+    # @return The RTC Token
+    def self.build_token_with_uid_and_privilege(app_id, app_certificate, channel_name, uid, token_expire,
+                                                join_channel_privilege_expire, pub_audio_privilege_expire,
+                                                pub_video_privilege_expire, pub_data_stream_privilege_expire)
+      build_token_with_user_account_and_privilege(
+        app_id, app_certificate, channel_name, uid, token_expire, join_channel_privilege_expire,
+        pub_audio_privilege_expire, pub_video_privilege_expire, pub_data_stream_privilege_expire
+      )
+    end
+
+    # Generates an RTC token with the specified privilege.
+    #
+    # This method supports generating a token with the following privileges:
+    # - Joining an RTC channel.
+    # - Publishing audio in an RTC channel.
+    # - Publishing video in an RTC channel.
+    # - Publishing data streams in an RTC channel.
+    #
+    # The privileges for publishing audio, video, and data streams in an RTC channel apply only if you have
+    # enabled co-host authentication.
+    #
+    # A user can have multiple privileges. Each privilege is valid for a maximum of 24 hours.
+    # The SDK triggers the onTokenPrivilegeWillExpire and onRequestToken callbacks when the token is about to expire
+    # or has expired. The callbacks do not report the specific privilege affected, and you need to maintain
+    # the respective timestamp for each privilege in your app logic. After receiving the callback, you need
+    # to generate a new token, and then call renewToken to pass the new token to the SDK, or call joinChannel to re-join
+    # the channel.
+    #
+    # @note
+    # Agora recommends setting a reasonable timestamp for each privilege according to your scenario.
+    # Suppose the expiration timestamp for joining the channel is set earlier than that for publishing audio.
+    # When the token for joining the channel expires, the user is immediately kicked off the RTC channel
+    # and cannot publish any audio stream, even though the timestamp for publishing audio has not expired.
+    #
+    # @param app_id The App ID of your Agora project.
+    # @param app_certificate The App Certificate of your Agora project.
+    # @param channel_name The unique channel name for the Agora RTC session in string format. The string length must be less than 64 bytes. The channel name may contain the following characters:
+    # - All lowercase English letters: a to z.
+    # - All uppercase English letters: A to Z.
+    # - All numeric characters: 0 to 9.
+    # - The space character.
+    # - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",".
+    # @param account The user account.
+    # @param token_expire represented by the number of seconds elapsed since now. If, for example, you want to access the
+    # Agora Service within 10 minutes after the token is generated, set token_expire as 600(seconds).
+    # @param join_channel_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to join channel and expect stay in the channel for 10 minutes, set join_channel_privilege_expire as 600(seconds).
+    # @param pub_audio_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to enable publish audio privilege for 10 minutes, set pub_audio_privilege_expire as 600(seconds).
+    # @param pub_video_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to enable publish video privilege for 10 minutes, set pub_video_privilege_expire as 600(seconds).
+    # @param pub_data_stream_privilege_expire represented by the number of seconds elapsed since now.
+    # If, for example, you want to enable publish data stream privilege for 10 minutes, set pub_data_stream_privilege_expire as 600(seconds).
+    # @return The RTC Token
+    def self.build_token_with_user_account_and_privilege(app_id, app_certificate, channel_name, account, token_expire,
+                                                         join_channel_privilege_expire, pub_audio_privilege_expire,
+                                                         pub_video_privilege_expire, pub_data_stream_privilege_expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, token_expire)
+      service_rtc = AgoraDynamicKey2::ServiceRtc.new(channel_name, account)
+
+      service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_JOIN_CHANNEL, join_channel_privilege_expire)
+      service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_AUDIO_STREAM, pub_audio_privilege_expire)
+      service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_VIDEO_STREAM, pub_video_privilege_expire)
+      service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_DATA_STREAM, pub_data_stream_privilege_expire)
+      access_token.add_service(service_rtc)
+      access_token.build
+    end
+
+    # Build the RTC and RTM token with account.
+    #
+    # app_id: The App ID issued to you by Agora. Apply for a new App ID from Agora Dashboard if it is missing
+    #     from your kit. See Get an App ID.
+    # app_certificate: Certificate of the application that you registered in the Agora Dashboard.
+    #     See Get an App Certificate.
+    # channel_name: Unique channel name for the AgoraRTC session in the string format.
+    # uid: User ID. A 32-bit unsigned integer with a value ranging from 1 to (2^32-1).
+    #     uid must be unique.
+    # role: ROLE_PUBLISHER: A broadcaster/host in a live-broadcast profile.
+    #     ROLE_SUBSCRIBER: An audience(default) in a live-broadcast profile.
+    # token_expire: represented by the number of seconds elapsed since now. If, for example,
+    #    you want to access the Agora Service within 10 minutes after the token is generated,
+    #    set token_expire as 600(seconds).
+    # privilege_expire: represented by the number of seconds elapsed since now. If, for example,
+    #    you want to enable your privilege for 10 minutes, set privilege_expire as 600(seconds).
+    # return: The RTC and RTM token.
+    def self.build_token_with_rtm(app_id, app_certificate, channel_name, account, role, token_expire, privilege_expire = 0)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, token_expire)
+      service_rtc = AgoraDynamicKey2::ServiceRtc.new(channel_name, account)
+
+      service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_JOIN_CHANNEL, privilege_expire)
+      if role == ROLE_PUBLISHER
+        service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_AUDIO_STREAM, privilege_expire)
+        service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_VIDEO_STREAM, privilege_expire)
+        service_rtc.add_privilege(AgoraDynamicKey2::ServiceRtc::PRIVILEGE_PUBLISH_DATA_STREAM, privilege_expire)
+      end
+      access_token.add_service(service_rtc)
+
+      service_rtm = AgoraDynamicKey2::ServiceRtm.new(account)
+
+      service_rtm.add_privilege(AgoraDynamicKey2::ServiceRtm::PRIVILEGE_JOIN_LOGIN, token_expire)
+      access_token.add_service(service_rtm)
+
+      access_token.build
+    end
+  end
+end

data/lib/dynamic_key2/rtm_token_builder.rb

@@ -0,0 +1,23 @@
+module AgoraDynamicKey2
+  class RtmTokenBuilder
+    # Build the RTM token.
+    #
+    # @param app_id:          The App ID issued to you by Agora. Apply for a new App ID from
+    #                         Agora Dashboard if it is missing from your kit. See Get an App ID.
+    # @param app_certificate: Certificate of the application that you registered in
+    #                         the Agora Dashboard. See Get an App Certificate.
+    # @param user_id:         The user's account, max length is 64 Bytes.
+    # @param expire:          represented by the number of seconds elapsed since now. If, for example, you want to access the
+    #                         Agora Service within 10 minutes after the token is generated, set expire as 600(seconds).
+    # @return The RTM token.
+    def self.build_token(app_id, app_certificate, user_id, expire)
+      access_token = AgoraDynamicKey2::AccessToken.new(app_id, app_certificate, expire)
+      service_rtm = AgoraDynamicKey2::ServiceRtm.new(user_id)
+
+      service_rtm.add_privilege(AgoraDynamicKey2::ServiceRtm::PRIVILEGE_JOIN_LOGIN, expire)
+      access_token.add_service(service_rtm)
+      access_token.build
+    end
+  end
+end
+

data/lib/dynamic_key2/util.rb

@@ -0,0 +1,61 @@
+require 'base64'
+
+module AgoraDynamicKey2
+  class Util
+    def self.pack_int16(int)
+      [int].pack('s')
+    end
+
+    def self.unpack_int16(data)
+      [data[0..2].unpack1('s'), data[2..-1]]
+    end
+
+    def self.pack_uint16(int)
+      [int].pack('v')
+    end
+
+    def self.unpack_uint16(data)
+      [data[0..2].unpack1('v'), data[2..-1]]
+    end
+
+    def self.pack_uint32(int)
+      [int].pack('V')
+    end
+
+    def self.unpack_uint32(data)
+      [data[0..4].unpack1('V'), data[4..-1]]
+    end
+
+    def self.pack_string(str)
+      pack_uint16(str.bytesize) + str
+    end
+
+    def self.unpack_string(data)
+      len, data = unpack_uint16(data)
+      if len.zero?
+        return ['', data[len..-1]]
+      end
+      [data[0..len - 1], data[len..-1]]
+    end
+
+    def self.pack_map_uint32(map)
+      kv = ''
+      Hash[map.sort].each do |k, v|
+        kv += pack_uint16(k) + pack_uint32(v)
+      end
+      (pack_uint16(map.size) + kv).force_encoding('utf-8')
+    end
+
+    def self.unpack_map_uint32(data)
+      len, data = unpack_uint16(data)
+      map = {}
+      (1..len).each do
+        k, data = unpack_uint16(data)
+        v, data = unpack_uint32(data)
+        map[k] = v
+      end
+      [map, data]
+    end
+  end
+end
+

data/lib/dynamic_key2.rb

@@ -0,0 +1,14 @@
+# code taken from https://github.com/AgoraIO/Tools
+
+require_relative 'dynamic_key2/access_token'
+require_relative 'dynamic_key2/apaas_token_builder'
+require_relative 'dynamic_key2/chat_token_builder'
+require_relative 'dynamic_key2/education_token_builder'
+require_relative 'dynamic_key2/fpa_token_builder'
+require_relative 'dynamic_key2/rtc_token_builder'
+require_relative 'dynamic_key2/rtm_token_builder'
+require_relative 'dynamic_key2/util'
+
+module AgoraDynamicKey2
+  VERSION = '0.2.0'.freeze
+end

data/lib/generators/agora_rails/install_generator.rb

@@ -0,0 +1,13 @@
+require 'rails/generators/base'
+
+module AgoraRails
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      def create_initializer_file
+        template "agora_rails.rb", "config/initializers/agora_rails.rb"
+      end
+    end
+  end
+end

data/lib/generators/agora_rails/templates/agora_rails.rb

@@ -0,0 +1,12 @@
+AgoraRails.configure do |config|
+  config.app_id = "YOUR_APP_ID"
+  config.app_certificate = "YOUR_APP_CERTIFICATE"
+  config.customer_key = "YOUR_CUSTOMER_KEY"
+  config.customer_secret = "YOUR_CUSTOMER_SECRET"
+
+  # the following are optional
+  config.bucket = "YOUR_BUCKET"
+  config.access_key = "YOUR_ACCESS_KEY"
+  config.secret_key = "YOUR_SECRET_KEY"
+  config.file_prefix = "YOUR_FILE_PREFIX"
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: agora_rails
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Mohammad Forouzani
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2024-11-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  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'
+- !ruby/object:Gem::Dependency
+  name: openssl
+  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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Provides functionality for Agora.io token generation and cloud recording
+email:
+- mo@usechance.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/agora_rails.rb
+- lib/agora_rails/cloud_recording.rb
+- lib/agora_rails/configuration.rb
+- lib/agora_rails/stt.rb
+- lib/dynamic_key2.rb
+- lib/dynamic_key2/access_token.rb
+- lib/dynamic_key2/apaas_token_builder.rb
+- lib/dynamic_key2/chat_token_builder.rb
+- lib/dynamic_key2/education_token_builder.rb
+- lib/dynamic_key2/fpa_token_builder.rb
+- lib/dynamic_key2/rtc_token_builder.rb
+- lib/dynamic_key2/rtm_token_builder.rb
+- lib/dynamic_key2/util.rb
+- lib/generators/agora_rails/install_generator.rb
+- lib/generators/agora_rails/templates/agora_rails.rb
+homepage: https://github.com/mamady/agora_rails
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.3
+signing_key: 
+specification_version: 4
+summary: Ruby interface for Agora.io APIs
+test_files: []