opentok 2.2.2 → 2.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f35fe580541ec8e9d7e973564f1f694aa9db2f95
-  data.tar.gz: 91c5359e1e171ced0b1fb9bf3462ef7dc752ea76
+  metadata.gz: dffed69e7386516ebc1f8d614cb08d0446796b8b
+  data.tar.gz: 273669ac8cfd0b3f6115e555ef4e94628d208261
 SHA512:
-  metadata.gz: 8b2f5014c9569169af71b3ae7c5ac60c05a9471cc98b178769ec3f1d2617c9db488fdcd36699984c7afa2213f7b947afe9faf43d3411a1d708d4951e7cf19081
-  data.tar.gz: 1fb580dc6f65cb050311c2f7dd7743851f3472f517714614c5643030b2b386f8f07ed4a8ebb59614d28d9827824b7f0c77cf8fb3239471945f6dbdfb88f95706
+  metadata.gz: 8bac951b35a12efa2458bb9e0678fb1bf5dd2a71be575796a94b9c65d60cc9b57d460c38bedf1295152db81d1c3789fd5557b0da05ba9c0d9daf53dc0af6d5f5
+  data.tar.gz: d03cae5de75bb2aa2934c7cc735fbba4a8ed23acf59222d2689efd921a3707c876e95376b744b974ea22384e91cd0584a7fc1f478e4379a193264f06efd27da2

data/.travis.yml

@@ -1,6 +1,9 @@
 language: ruby
 rvm:
-  - "1.9.3"
-  - "2.0.0"
-  - "2.1.0"
-  - rbx-2
+- 1.9.3
+- 2.0.0
+- 2.1.0
+- rbx-2
+notifications:
+  slack:
+    secure: agVll2R9PTPvJMcUgbvOh9eGt60zGDc8kPUwEsiQr828rCgXh/ZxD5irYDyKQg3ZsS8+f3MjFCwzU7uQALkia2pDrie9d8g8m1dt4Q5U7Qm6QecshvE0U9JwbB5Ngxaftbqyf0XEFrE7CKs7RI1BzFRpe8m+fdZgfwccX8Gb7pc=

data/README.md

@@ -9,7 +9,7 @@ The OpenTok Ruby SDK lets you generate
 [archive](http://www.tokbox.com/platform/archiving) OpenTok 2.0 sessions.
 
 If you are updating from a previous version of this SDK, see
-[Important changes in v2.2](#important-changes-in-v22).
+[Important changes since v2.2.0](#important-changes-since-v220).
 
 # Installation
 
@@ -172,7 +172,17 @@ The OpenTok Ruby SDK requires Ruby 1.9.3 or greater.
 See the [Releases](https://github.com/opentok/opentok-ruby-sdk/releases) page for details
 about each release.
 
-## Important changes in v2.2
+## Important changes since v2.2.0
+
+**Changes in v2.2.2:**
+
+The default setting for the `create_session()` method is to create a session with the media mode set
+to relayed. In previous versions of the SDK, the default setting was to use the OpenTok Media Router
+(media mode set to routed). In a relayed session, clients will attempt to send streams directly
+between each other (peer-to-peer); if clients cannot connect due to firewall restrictions, the
+session uses the OpenTok TURN server to relay audio-video streams.
+
+**Changes in v2.2.0:**
 
 This version of the SDK includes support for working with OpenTok 2.0 archives. (This API does not
 work with OpenTok 1.0 archives.)

data/doc/OpenTok.html

@@ -384,7 +384,7 @@ cannot be updated once it is set.</p>
   <span class='comment'># @private
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_api_key'>api_key</span><span class='comma'>,</span> <span class='id identifier rubyid_api_secret'>api_secret</span><span class='comma'>,</span> <span class='id identifier rubyid_session_id'>session_id</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
     <span class='ivar'>@api_key</span><span class='comma'>,</span> <span class='ivar'>@api_secret</span><span class='comma'>,</span> <span class='ivar'>@session_id</span> <span class='op'>=</span> <span class='id identifier rubyid_api_key'>api_key</span><span class='comma'>,</span> <span class='id identifier rubyid_api_secret'>api_secret</span><span class='comma'>,</span> <span class='id identifier rubyid_session_id'>session_id</span>
-    <span class='ivar'>@media_mode</span><span class='comma'>,</span> <span class='ivar'>@location</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='comma'>,</span> <span class='symbol'>:routed</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:location</span><span class='rbracket'>]</span>
+    <span class='ivar'>@media_mode</span><span class='comma'>,</span> <span class='ivar'>@location</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='comma'>,</span> <span class='symbol'>:relayed</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:location</span><span class='rbracket'>]</span>
   <span class='kw'>end</span>
 
   <span class='comment'># @private
@@ -402,7 +402,7 @@ cannot be updated once it is set.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/Archive.html

@@ -499,18 +499,18 @@ exceeded", "failure", "session ended", or "user initiated".</p>
       <pre class="lines">
 
 
-82
-83
 84
 85
 86
 87
 88
 89
-90</pre>
+90
+91
+92</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 82</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 84</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_method_missing'>method_missing</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_camelized_method'>camelized_method</span> <span class='op'>=</span> <span class='id identifier rubyid_method'>method</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_camelize'>camelize</span><span class='lparen'>(</span><span class='symbol'>:lower</span><span class='rparen'>)</span>
@@ -578,12 +578,12 @@ epoch.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_created_at'>created_at</span>
   <span class='ivar'>@created_at</span>
@@ -639,12 +639,12 @@ epoch.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_duration'>duration</span>
   <span class='ivar'>@duration</span>
@@ -700,12 +700,12 @@ epoch.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_id'>id</span>
   <span class='ivar'>@id</span>
@@ -762,12 +762,12 @@ created, this is set to null.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_name'>name</span>
   <span class='ivar'>@name</span>
@@ -823,12 +823,12 @@ created, this is set to null.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_partner_id'>partner_id</span>
   <span class='ivar'>@partner_id</span>
@@ -886,12 +886,12 @@ with the status "failed", this can be set to "system failure".</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_reason'>reason</span>
   <span class='ivar'>@reason</span>
@@ -947,12 +947,12 @@ with the status "failed", this can be set to "system failure".</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_session_id'>session_id</span>
   <span class='ivar'>@session_id</span>
@@ -1009,12 +1009,12 @@ value is set to 0.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_size'>size</span>
   <span class='ivar'>@size</span>
@@ -1043,6 +1043,9 @@ value is set to 0.</p>
 <p>"available" -- The archive is available for download from the OpenTok
 cloud.</p>
 </li><li>
+<p>"expired" -- The archive is no longer available for download from the
+OpenTok cloud.</p>
+</li><li>
 <p>"failed" -- The archive recording failed.</p>
 </li><li>
 <p>"started" -- The archive started and is in the process of being recorded.</p>
@@ -1050,7 +1053,9 @@ cloud.</p>
 <p>"stopped" -- The archive stopped recording.</p>
 </li><li>
 <p>"uploaded" -- The archive is available for download from the the upload
-target S3 bucket.</p>
+target Amazon S3 bucket or Windows Azure container you set at the OpenTok
+dashboard (<a
+href="https://dashboard.tokbox.com">dashboard.tokbox.com</a>).</p>
 </li></ul>
 
 
@@ -1083,12 +1088,12 @@ target S3 bucket.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_status'>status</span>
   <span class='ivar'>@status</span>
@@ -1149,12 +1154,12 @@ OpenTok.getArchive() method.</p>
       <pre class="lines">
 
 
-48
-49
-50</pre>
+50
+51
+52</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 50</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_url'>url</span>
   <span class='ivar'>@url</span>
@@ -1202,13 +1207,13 @@ making it unavailable for download.</p>
       <pre class="lines">
 
 
-76
-77
 78
-79</pre>
+79
+80
+81</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 76</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 78</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_delete'>delete</span>
   <span class='comment'># TODO: validate returned json fits schema
@@ -1248,13 +1253,13 @@ have disconnected from the session being archived.</p>
       <pre class="lines">
 
 
-66
-67
 68
-69</pre>
+69
+70
+71</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 66</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 68</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_stop'>stop</span>
   <span class='comment'># TODO: validate returned json fits schema
@@ -1291,12 +1296,12 @@ have disconnected from the session being archived.</p>
       <pre class="lines">
 
 
-58
-59
-60</pre>
+60
+61
+62</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 58</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archive.rb', line 60</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_to_json'>to_json</span>
   <span class='ivar'>@json</span><span class='period'>.</span><span class='id identifier rubyid_to_json'>to_json</span>
@@ -1311,7 +1316,7 @@ have disconnected from the session being archived.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/ArchiveList.html

@@ -207,7 +207,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/Archives.html

@@ -373,14 +373,14 @@ archives returned is 1000.</p>
       <pre class="lines">
 
 
-73
 74
 75
 76
-77</pre>
+77
+78</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 73</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 74</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_all'>all</span><span class='lparen'>(</span><span class='id identifier rubyid_options'>options</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Limit is invalid</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:count</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='kw'>or</span> <span class='lparen'>(</span><span class='int'>0</span><span class='op'>..</span><span class='int'>100</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:count</span><span class='rbracket'>]</span>
@@ -410,8 +410,9 @@ archives returned is 1000.</p>
 successfully start recording an archive.</p>
 
 <p>You can only record one archive at a time for a given session. You can only
-record archives of OpenTok server-enabled sessions; you cannot archive
-peer-to-peer sessions.</p>
+record archives of sessions that use the OpenTok Media Router (sessions
+with the media mode set to routed); you cannot archive sessions with the
+media mode set to relayed.</p>
 
 
   </div>
@@ -584,16 +585,16 @@ session is already being recorded.</p>
       <pre class="lines">
 
 
-39
 40
 41
 42
 43
 44
-45</pre>
+45
+46</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 39</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 40</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_create'>create</span><span class='lparen'>(</span><span class='id identifier rubyid_session_id'>session_id</span><span class='comma'>,</span> <span class='id identifier rubyid_options'>options</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>session_id not provided</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_session_id'>session_id</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
@@ -706,14 +707,14 @@ archive remains deleted.</p>
       <pre class="lines">
 
 
-113
 114
 115
 116
-117</pre>
+117
+118</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 113</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 114</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_delete_by_id'>delete_by_id</span><span class='lparen'>(</span><span class='id identifier rubyid_archive_id'>archive_id</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>archive_id not provided</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_archive_id'>archive_id</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
@@ -835,14 +836,14 @@ archive remains deleted.</p>
       <pre class="lines">
 
 
-56
 57
 58
 59
-60</pre>
+60
+61</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 56</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 57</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_find'>find</span><span class='lparen'>(</span><span class='id identifier rubyid_archive_id'>archive_id</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>archive_id not provided</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_archive_id'>archive_id</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
@@ -995,14 +996,14 @@ have disconnected from the session being archived.</p>
       <pre class="lines">
 
 
-94
 95
 96
 97
-98</pre>
+98
+99</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 94</span>
+      <pre class="code"><span class="info file"># File 'lib/opentok/archives.rb', line 95</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_stop_by_id'>stop_by_id</span><span class='lparen'>(</span><span class='id identifier rubyid_archive_id'>archive_id</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>archive_id not provided</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_archive_id'>archive_id</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
@@ -1019,7 +1020,7 @@ have disconnected from the session being archived.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/OpenTok.html

@@ -501,10 +501,6 @@ video returns.</p>
 <p>The OpenTok Media Router supports the <a href="http://tokbox.com/platform/archiving" target="_parent" title="archiving">archiving</a> feature, which lets you record, save, and retrieve OpenTok
 sessions.</p>
 </li></ul>
-
-<p>You will be billed for streamed minutes if you use the OpenTok Media Router
-or if the session uses the OpenTok TURN server to relay streams. For
-information on pricing, see the <a href="http://www.tokbox.com/pricing" target="_parent" title="OpenTok pricing page">OpenTok pricing page</a>.</p>
 </div>
           
         </li>
@@ -605,11 +601,11 @@ ID.</p>
   <span class='comment'># anything other than :relayed sets the REST param to &quot;disabled&quot;, in which case we force
 </span>  <span class='comment'># opts to be :routed. if we were more strict we could raise an error when the value isn't
 </span>  <span class='comment'># either :relayed or :routed
-</span>  <span class='kw'>if</span> <span class='id identifier rubyid_params'>params</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='rparen'>)</span> <span class='op'>==</span> <span class='symbol'>:relayed</span>
-    <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>p2p.preference</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>enabled</span><span class='tstring_end'>&quot;</span></span>
-  <span class='kw'>else</span>
+</span>  <span class='kw'>if</span> <span class='id identifier rubyid_params'>params</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='rparen'>)</span> <span class='op'>==</span> <span class='symbol'>:routed</span>
     <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>p2p.preference</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>disabled</span><span class='tstring_end'>&quot;</span></span>
-    <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:media_mode</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='symbol'>:routed</span>
+  <span class='kw'>else</span>
+    <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>p2p.preference</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>enabled</span><span class='tstring_end'>&quot;</span></span>
+    <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:media_mode</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='symbol'>:relayed</span>
   <span class='kw'>end</span>
   <span class='comment'># location is optional, but it has to be an IP address if specified at all
 </span>  <span class='kw'>unless</span> <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='symbol'>:location</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
@@ -974,10 +970,6 @@ cannot be updated once it is set.</p>
 </span>  <span class='comment'>#   * The OpenTok Media Router supports the {http://tokbox.com/platform/archiving archiving}
 </span>  <span class='comment'>#     feature, which lets you record, save, and retrieve OpenTok sessions.
 </span>  <span class='comment'>#
-</span>  <span class='comment'>#   You will be billed for streamed minutes if you use the OpenTok Media Router or if the
-</span>  <span class='comment'>#   session uses the OpenTok TURN server to relay streams. For information on pricing, see the
-</span>  <span class='comment'>#   {http://www.tokbox.com/pricing OpenTok pricing page}.
-</span>  <span class='comment'>#
 </span>  <span class='comment'># @option opts [String] :location  An IP address that the OpenTok servers will use to
 </span>  <span class='comment'>#     situate the session in its global network. If you do not set a location hint,
 </span>  <span class='comment'>#     the OpenTok servers will be based on the first client connecting to the session.
@@ -1000,11 +992,11 @@ cannot be updated once it is set.</p>
     <span class='comment'># anything other than :relayed sets the REST param to &quot;disabled&quot;, in which case we force
 </span>    <span class='comment'># opts to be :routed. if we were more strict we could raise an error when the value isn't
 </span>    <span class='comment'># either :relayed or :routed
-</span>    <span class='kw'>if</span> <span class='id identifier rubyid_params'>params</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='rparen'>)</span> <span class='op'>==</span> <span class='symbol'>:relayed</span>
-      <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>p2p.preference</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>enabled</span><span class='tstring_end'>&quot;</span></span>
-    <span class='kw'>else</span>
+</span>    <span class='kw'>if</span> <span class='id identifier rubyid_params'>params</span><span class='period'>.</span><span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='rparen'>)</span> <span class='op'>==</span> <span class='symbol'>:routed</span>
       <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>p2p.preference</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>disabled</span><span class='tstring_end'>&quot;</span></span>
-      <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:media_mode</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='symbol'>:routed</span>
+    <span class='kw'>else</span>
+      <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>p2p.preference</span><span class='tstring_end'>&quot;</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>enabled</span><span class='tstring_end'>&quot;</span></span>
+      <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:media_mode</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='symbol'>:relayed</span>
     <span class='kw'>end</span>
     <span class='comment'># location is optional, but it has to be an IP address if specified at all
 </span>    <span class='kw'>unless</span> <span class='id identifier rubyid_params'>params</span><span class='lbracket'>[</span><span class='symbol'>:location</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
@@ -1037,7 +1029,7 @@ cannot be updated once it is set.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/OpenTokArchiveError.html

@@ -133,7 +133,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/OpenTokAuthenticationError.html

@@ -134,7 +134,7 @@ OpenTok API key or secret.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/OpenTokError.html

@@ -129,7 +129,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/OpenTok/Session.html

@@ -638,7 +638,7 @@ cannot be updated once it is set.</p>
   <span class='comment'># @private
 </span>  <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_api_key'>api_key</span><span class='comma'>,</span> <span class='id identifier rubyid_api_secret'>api_secret</span><span class='comma'>,</span> <span class='id identifier rubyid_session_id'>session_id</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
     <span class='ivar'>@api_key</span><span class='comma'>,</span> <span class='ivar'>@api_secret</span><span class='comma'>,</span> <span class='ivar'>@session_id</span> <span class='op'>=</span> <span class='id identifier rubyid_api_key'>api_key</span><span class='comma'>,</span> <span class='id identifier rubyid_api_secret'>api_secret</span><span class='comma'>,</span> <span class='id identifier rubyid_session_id'>session_id</span>
-    <span class='ivar'>@media_mode</span><span class='comma'>,</span> <span class='ivar'>@location</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='comma'>,</span> <span class='symbol'>:routed</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:location</span><span class='rbracket'>]</span>
+    <span class='ivar'>@media_mode</span><span class='comma'>,</span> <span class='ivar'>@location</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='symbol'>:media_mode</span><span class='comma'>,</span> <span class='symbol'>:relayed</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='lbracket'>[</span><span class='symbol'>:location</span><span class='rbracket'>]</span>
   <span class='kw'>end</span>
 
   <span class='comment'># @private
@@ -656,7 +656,7 @@ cannot be updated once it is set.</p>
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/_index.html

@@ -173,7 +173,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/file.README.html

@@ -78,7 +78,7 @@
 </div></div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/index.html

@@ -78,7 +78,7 @@
 </div></div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Jun 16 23:06:55 2014 by
+  Generated on Fri Jun 20 12:49:10 2014 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.4 (ruby-1.9.3).
 </div>

data/lib/opentok/archive.rb

@@ -34,11 +34,13 @@ module OpenTok
     #   The status of the archive, which can be one of the following:
     #
     #   * "available" -- The archive is available for download from the OpenTok cloud.
+    #   * "expired" -- The archive is no longer available for download from the OpenTok cloud.
     #   * "failed" -- The archive recording failed.
     #   * "started" -- The archive started and is in the process of being recorded.
     #   * "stopped" -- The archive stopped recording.
     #   * "uploaded" -- The archive is available for download from the the upload target
-    #     S3 bucket.
+    #     Amazon S3 bucket or Windows Azure container you set at the OpenTok dashboard
+    #     (https://dashboard.tokbox.com).
     #
     # @attr [string] url
     #   The download URL of the available MP4 file. This is only set for an archive with the status set to

data/lib/opentok/archives.rb

@@ -17,7 +17,8 @@ module OpenTok
     # recording an archive.
     #
     # You can only record one archive at a time for a given session. You can only record archives
-    # of OpenTok server-enabled sessions; you cannot archive peer-to-peer sessions.
+    # of sessions that use the OpenTok Media Router (sessions with the media mode set to routed);
+    # you cannot archive sessions with the media mode set to relayed.
     #
     # @param [String] session_id The session ID of the OpenTok session to archive.
     # @param [Hash] options  A hash with the key 'name' or :name.

data/lib/opentok/opentok.rb

@@ -118,10 +118,6 @@ module OpenTok
     #   * The OpenTok Media Router supports the {http://tokbox.com/platform/archiving archiving}
     #     feature, which lets you record, save, and retrieve OpenTok sessions.
     #
-    #   You will be billed for streamed minutes if you use the OpenTok Media Router or if the
-    #   session uses the OpenTok TURN server to relay streams. For information on pricing, see the
-    #   {http://www.tokbox.com/pricing OpenTok pricing page}.
-    #
     # @option opts [String] :location  An IP address that the OpenTok servers will use to
     #     situate the session in its global network. If you do not set a location hint,
     #     the OpenTok servers will be based on the first client connecting to the session.

data/lib/opentok/version.rb

@@ -1,4 +1,4 @@
 module OpenTok
   # @private
-  VERSION = '2.2.2'
+  VERSION = '2.2.3'
 end

data/opentok.gemspec

@@ -29,6 +29,6 @@ Gem::Specification.new do |spec|
   # spec.add_development_dependency "debugger", "~> 1.6.6"
 
   spec.add_dependency "addressable", "~> 2.3" #  2.3.0 <= version < 3.0.0
-  spec.add_dependency "httparty", "~> 0.8"
+  spec.add_dependency "httparty", "~> 0.13.1"
   spec.add_dependency "activesupport", ">= 2.0"
 end

data/sample/Archiving/README.md

@@ -22,7 +22,7 @@ $ export API_SECRET=abcdef1234567890abcdef01234567890abcdef
 Finally, start the server using Bundler to handle dependencies
 
 ```
-$ bundle exec ruby hello_world.rb
+$ bundle exec ruby archiving_sample.rb
 ```
 
 Visit <http://localhost:9393> in your browser. You can now create new archives (either as a host or

data/spec/cassettes/OpenTok_Archives/should_find_archives_by_id.yml

@@ -39,8 +39,9 @@ http_interactions:
           "sessionId" : "SESSIONID",
           "size" : 8347554,
           "status" : "available",
-          "url" : "http://tokbox.com.archive2.s3.amazonaws.com/123456%2Ff6e7ee58-d6cf-4a59-896b-6d56b158ec71%2Farchive.mp4?Expires=1395194362&AWSAccessKeyId=AKIAI6LQCPIXYVWCQV6Q&Signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+          "url" : "http://tokbox.com.archive2.s3.amazonaws.com/123456%2Ff6e7ee58-d6cf-4a59-896b-6d56b158ec71%2Farchive.mp4?Expires=1395194362&AWSAccessKeyId=AKIAI6LQCPIXYVWCQV6Q&Signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+          "notarealproperty" : "not a real value"
         }
-    http_version: 
+    http_version:
   recorded_at: Wed, 19 Mar 2014 01:49:22 GMT
 recorded_with: VCR 2.8.0

data/spec/cassettes/OpenTok_Archives/should_find_archives_with_unknown_properties.yml

@@ -0,0 +1,46 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.opentok.com/v2/partner/123456/archive/f6e7ee58-d6cf-4a59-896b-6d56b158ec71
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Tb-Partner-Auth:
+      - 123456:1234567890abcdef1234567890abcdef1234567890
+      User-Agent:
+      - OpenTok-Ruby-SDK/<%= version %>
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Wed, 19 Mar 2014 01:49:22 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: |-
+        {
+          "createdAt" : 1395187836000,
+          "duration" : 62,
+          "id" : "f6e7ee58-d6cf-4a59-896b-6d56b158ec71",
+          "name" : "",
+          "partnerId" : 123456,
+          "reason" : "",
+          "sessionId" : "SESSIONID",
+          "size" : 8347554,
+          "status" : "available",
+          "url" : "http://tokbox.com.archive2.s3.amazonaws.com/123456%2Ff6e7ee58-d6cf-4a59-896b-6d56b158ec71%2Farchive.mp4?Expires=1395194362&AWSAccessKeyId=AKIAI6LQCPIXYVWCQV6Q&Signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+        }
+    http_version: 
+  recorded_at: Wed, 19 Mar 2014 01:49:22 GMT
+recorded_with: VCR 2.8.0

data/spec/cassettes/OpenTok_Archives/should_find_expired_archives.yml

@@ -0,0 +1,46 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.opentok.com/v2/partner/123456/archive/f6e7ee58-d6cf-4a59-896b-6d56b158ec71
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Tb-Partner-Auth:
+      - 123456:1234567890abcdef1234567890abcdef1234567890
+      User-Agent:
+      - OpenTok-Ruby-SDK/<%= version %>
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Wed, 19 Mar 2014 01:49:22 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: |-
+        {
+          "createdAt" : 1395187836000,
+          "duration" : 62,
+          "id" : "f6e7ee58-d6cf-4a59-896b-6d56b158ec71",
+          "name" : "",
+          "partnerId" : 123456,
+          "reason" : "",
+          "sessionId" : "SESSIONID",
+          "size" : 8347554,
+          "status" : "expired",
+          "url" : null
+        }
+    http_version:
+  recorded_at: Wed, 19 Mar 2014 01:49:22 GMT
+recorded_with: VCR 2.8.0

data/spec/opentok/archives_spec.rb

@@ -55,6 +55,17 @@ describe OpenTok::Archives do
     # expect(archive.status).to eq ""
   end
 
+  it "should find expired archives", :vcr => { :erb => { :version => OpenTok::VERSION } } do
+    archive = archives.find findable_archive_id
+    expect(archive).to be_an_instance_of OpenTok::Archive
+    expect(archive.status).to eq "expired"
+  end
+
+  it "should find archives with unknown properties", :vcr => { :erb => { :version => OpenTok::VERSION } } do
+    archive = archives.find findable_archive_id
+    expect(archive).to be_an_instance_of OpenTok::Archive
+  end
+
   # TODO: context "with a session that has no participants" do
   #   let(:session_id) { "" }
   #   it "should refuse to create archives with appropriate error" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentok
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 2.2.3
 platform: ruby
 authors:
 - Stijn Mathysen
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-17 00:00:00.000000000 Z
+date: 2014-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -118,14 +118,14 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: 0.13.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: 0.13.1
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -227,6 +227,8 @@ files:
 - spec/cassettes/OpenTok_Archives/should_create_named_archives.yml
 - spec/cassettes/OpenTok_Archives/should_delete_an_archive_by_id.yml
 - spec/cassettes/OpenTok_Archives/should_find_archives_by_id.yml
+- spec/cassettes/OpenTok_Archives/should_find_archives_with_unknown_properties.yml
+- spec/cassettes/OpenTok_Archives/should_find_expired_archives.yml
 - spec/cassettes/OpenTok_Archives/should_stop_archives.yml
 - spec/cassettes/OpenTok_Archives/when_many_archives_are_created/should_return_all_archives.yml
 - spec/cassettes/OpenTok_Archives/when_many_archives_are_created/should_return_archives_with_an_offset.yml
@@ -275,6 +277,8 @@ test_files:
 - spec/cassettes/OpenTok_Archives/should_create_named_archives.yml
 - spec/cassettes/OpenTok_Archives/should_delete_an_archive_by_id.yml
 - spec/cassettes/OpenTok_Archives/should_find_archives_by_id.yml
+- spec/cassettes/OpenTok_Archives/should_find_archives_with_unknown_properties.yml
+- spec/cassettes/OpenTok_Archives/should_find_expired_archives.yml
 - spec/cassettes/OpenTok_Archives/should_stop_archives.yml
 - spec/cassettes/OpenTok_Archives/when_many_archives_are_created/should_return_all_archives.yml
 - spec/cassettes/OpenTok_Archives/when_many_archives_are_created/should_return_archives_with_an_offset.yml