DEVX-9004: Implementing max bitrate for archives (#288)

* Implementing max bitrate for archives

Author: superchilled

CHANGES.md

@@ -1,3 +1,7 @@
+# 4.12.0
+
+* Updating the `Archives#create` method to allow `max_bitrate` as an option. See [#288](https://github.com/opentok/OpenTok-Ruby-SDK/pull/288)
+
 # 4.11.0
 
 * Updating client token creation to use JWTs by default. See [#287](https://github.com/opentok/OpenTok-Ruby-SDK/pull/274)

lib/opentok/archives.rb

@@ -79,6 +79,10 @@ def initialize(client)
     #   layout type. For more information, see
     #   {https://tokbox.com/developer/guides/archiving/layout-control.html Customizing
     #   the video layout for composed archives}.
+    # @option options [Integer] :max_bitrate (Optional) The maximum video bitrate for the archive, in bits per second. The minimum 
+    #   value is 100,000 and the maximum is 6,000,000. This option is only valid for composed archives. Set the maximum video bitrate
+    #   to control the size of the composed archive. This maximum bitrate applies to the video bitrate only. If the output archive has
+    #   audio, those bits will be excluded from the limit.
     #
     # @return [Archive] The Archive object, which includes properties defining the archive,
     #   including the archive ID.
@@ -105,7 +109,8 @@ def create(session_id, options = {})
         :resolution,
         :layout,
         :multi_archive_tag,
-        :stream_mode
+        :stream_mode,
+        :max_bitrate
       ]
       opts = options.inject({}) do |m,(k,v)|
         if valid_opts.include? k.to_sym

lib/opentok/version.rb

@@ -1,4 +1,4 @@
 module OpenTok
   # @private
-  VERSION = '4.11.0'
+  VERSION = '4.12.0'
 end

spec/cassettes/OpenTok_Archives/should_create_an_archive_with_maxBitrate_set_to_specified_max_bitrate_value.yml

@@ -70,6 +70,13 @@
     expect(archive.stream_mode).to eq stream_mode
   end
 
+  it "should create an archive with maxBitrate set to specified max_bitrate value", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    max_bitrate = 200000
+    archive = archives.create session_id, :max_bitrate => max_bitrate
+    expect(archive).to be_an_instance_of OpenTok::Archive
+    expect(archive.max_bitrate).to eq max_bitrate
+  end
+
   it "should create audio only archives", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
     archive = archives.create session_id, :has_video => false
     expect(archive).to be_an_instance_of OpenTok::Archive