You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<divclass="block">Returns a List of <ahref="../../com/opentok/Archive.html" title="class in com.opentok"><code>Archive</code></a> objects, representing archives that are both
200
200
both completed and in-progress, for your API key.</div>
201
201
</td>
202
202
</tr>
203
203
<trclass="altColor">
204
204
<tdclass="colFirst"><code><ahref="../../com/opentok/Archive.html" title="class in com.opentok">Archive</a></code></td>
<divclass="block">Stops an OpenTok archive that is being recorded.</div>
214
223
</td>
@@ -365,7 +374,7 @@ <h4>generateToken</h4>
365
374
<dl><dt><spanclass="strong">Parameters:</span></dt><dd><code>sessionId</code> - The session ID corresponding to the session to which the user will connect.</dd>
OT.initSession()</a> method (to initialize an OpenTok session).
384
393
<p>
385
394
OpenTok sessions do not expire. However, authentication tokens do expire (see the
386
-
<ahref="../../com/opentok/OpenTok.html#generateToken(java.lang.String,%20com.opentok.TokenOptions)"><code>generateToken(String, TokenOptions)</code></a> method). Also note that sessions cannot
395
+
<ahref="../../com/opentok/OpenTok.html#generateToken(java.lang.String, com.opentok.TokenOptions)"><code>generateToken(String, TokenOptions)</code></a> method). Also note that sessions cannot
387
396
explicitly be destroyed.
388
397
<p>
389
398
A session ID string can be up to 255 characters long.
@@ -504,7 +513,7 @@ <h4>listArchives</h4>
504
513
<divclass="block">Returns a List of <ahref="../../com/opentok/Archive.html" title="class in com.opentok"><code>Archive</code></a> objects, representing archives that are both
505
514
both completed and in-progress, for your API key. This list is limited to 1000 archives
506
515
starting with the first archive recorded. For a specific range of archives, call
507
-
<ahref="../../com/opentok/OpenTok.html#listArchives(int,%20int)"><code>listArchives(int offset, int count)</code></a>.</div>
516
+
<ahref="../../com/opentok/OpenTok.html#listArchives(int, int)"><code>listArchives(int offset, int count)</code></a>.</div>
508
517
<dl><dt><spanclass="strong">Returns:</span></dt><dd>A List of <ahref="../../com/opentok/Archive.html" title="class in com.opentok"><code>Archive</code></a> objects.</dd>
509
518
<dt><spanclass="strong">Throws:</span></dt>
510
519
<dd><code><ahref="../../com/opentok/exception/OpenTokException.html" title="class in com.opentok.exception">OpenTokException</a></code></dd></dl>
@@ -539,7 +548,36 @@ <h4>startArchive</h4>
539
548
<pre>public <ahref="../../com/opentok/Archive.html" title="class in com.opentok">Archive</a> startArchive(java.lang.String sessionId,
540
549
java.lang.String name)
541
550
throws <ahref="../../com/opentok/exception/OpenTokException.html" title="class in com.opentok.exception">OpenTokException</a></pre>
542
-
<divclass="block">Starts archiving an OpenTok 2.0 session.
551
+
<divclass="block">Starts archiving an OpenTok session. This version of the <code>startArchive()</code> method
552
+
lets you disable audio or video recording.
553
+
554
+
<p>
555
+
Clients must be actively connected to the OpenTok session for you to successfully start recording an archive.
556
+
<p>
557
+
You can only record one archive at a time for a given session. You can only record archives
558
+
of sessions that use the OpenTok Media Router (sessions with the
set to routed); you cannot archive sessions with the media mode set to relayed.</div>
561
+
<dl><dt><spanclass="strong">Parameters:</span></dt><dd><code>sessionId</code> - The session ID of the OpenTok session to archive.</dd><dd><code>name</code> - The name of the archive. You can use this name to identify the archive. It is a property
562
+
of the Archive object, and it is a property of archive-related events in the OpenTok client libraries.</dd>
563
+
<dt><spanclass="strong">Returns:</span></dt><dd>The Archive object. This object includes properties defining the archive, including the archive ID.</dd>
564
+
<dt><spanclass="strong">Throws:</span></dt>
565
+
<dd><code><ahref="../../com/opentok/exception/OpenTokException.html" title="class in com.opentok.exception">OpenTokException</a></code></dd></dl>
set to routed); you cannot archive sessions with the media mode set to relayed.</div>
551
589
<dl><dt><spanclass="strong">Parameters:</span></dt><dd><code>sessionId</code> - The session ID of the OpenTok session to archive.</dd><dd><code>name</code> - The name of the archive. You can use this name to identify the archive. It is a property
552
-
of the Archive object, and it is a property of archive-related events in the OpenTok JavaScript SDK.</dd>
590
+
of the Archive object, and it is a property of archive-related events in the OpenTok client libraries.</dd><dd><code>hasVideo</code> - Whether the archive will include an audio track (<code>true</code>) or not
591
+
<code>false</code>). The default value is <code>true</code> (an audio track is included). If you set
592
+
both <code>hasAudio</code> and <code>hasAudio</code> to <code>false</code>, the call to the
593
+
<code>startArchive()</code> method results in an error.</dd><dd><code>hasAudio</code> - Whether the archive will include a video track (<code>true</code>) or not
594
+
<code>false</code>). The default value is <code>true</code> (a video track is included). If you set
595
+
both <code>hasAudio</code> and <code>hasAudio</code> to <code>false</code>, the call to the
596
+
<code>startArchive()</code> method results in an error.</dd>
553
597
<dt><spanclass="strong">Returns:</span></dt><dd>The Archive object. This object includes properties defining the archive, including the archive ID.</dd>
554
598
<dt><spanclass="strong">Throws:</span></dt>
555
599
<dd><code><ahref="../../com/opentok/exception/OpenTokException.html" title="class in com.opentok.exception">OpenTokException</a></code></dd></dl>
@@ -568,7 +612,7 @@ <h4>stopArchive</h4>
568
612
Archives automatically stop recording after 90 minutes or when all clients have disconnected from the
569
613
session being archived.</div>
570
614
<dl><dt><spanclass="strong">Parameters:</span></dt><dd><code>archiveId</code> - The archive ID of the archive you want to stop recording.</dd>
571
-
<dt><spanclass="strong">Returns:</span></dt><dd>The Archive object corresponding to the archive being STOPPED.</dd>
615
+
<dt><spanclass="strong">Returns:</span></dt><dd>The Archive object corresponding to the archive being stopped.</dd>
572
616
<dt><spanclass="strong">Throws:</span></dt>
573
617
<dd><code><ahref="../../com/opentok/exception/OpenTokException.html" title="class in com.opentok.exception">OpenTokException</a></code></dd></dl>
0 commit comments