Docs additions for archive hasAudio/hasVideo

Author: jeffswartz

README.rst

@@ -101,6 +101,16 @@ a Session that has clients connection.
   # Store this archive_id in the database
   archive_id = archive.id
 
+You can also disable audio or video recording by setting the `hasAudio` or `hasVideo` property of
+the `options` parameter to `false`:
+
+.. code:: python
+
+  archive = opentok.start_archive(session_id, name=u'Important Presentation', hasVideo=False)
+
+  # Store this archive_id in the database
+  archive_id = archive.id
+
 You can stop the recording of a started Archive using the ``opentok.stop_archive(archive_id)``
 method. You can also do this using the ``archive.stop()`` method of an ``Archive`` instance.
 

opentok/archives.py

@@ -19,6 +19,14 @@ class Archive(object):
     :ivar duration:
        The duration of the archive, in milliseconds.
 
+    :ivar hasAudio:
+       Boolean value set to true when the archive contains an audio track,
+       and set to false otherwise.
+
+    :ivar hasVideo:
+       Boolean value set to true when the archive contains a video track,
+       and set to false otherwise.
+
     :ivar id:
        The archive ID.
 
@@ -52,14 +60,6 @@ class Archive(object):
          Amazon S3 bucket or Windows Azure container that you set at the
          `OpenTok dashboard <https://dashboard.tokbox.com>`_.
 
-    :ivar hasAudio:
-       Boolean value set to true when the archive contains an audio track,
-       and set to false otherwise.
-
-    :ivar hasVideo:
-       Boolean value set to true when the archive contains a video track,
-       and set to false otherwise.
-
     :ivar url:
        The download URL of the available MP4 file. This is only set for an archive with the status set to
        "available"; for other archives, (including archives with the status "uploaded") this property is

opentok/opentok.py

@@ -278,8 +278,12 @@ def start_archive(self, session_id, hasAudio=True, hasVideo=True, name=None):
         :param String name: This is the name of the archive. You can use this name
           to identify the archive. It is a property of the Archive object, and it is a property
           of archive-related events in the OpenTok.js library.
-        :param Boolean hasAudio: if set to true, an audio track will be inserted to the archive. hasAudio is an optional parameter that is set to true by default.
-        :param Boolean hasVideo: if set to true, a video track will be inserted to the archive. hasVideo is an optional parameter that is set to true by default.
+        :param Boolean hasAudio: if set to True, an audio track will be inserted to the archive.
+          hasAudio is an optional parameter that is set to True by default. If you set both
+          hasAudio and hasVideo to False, the call to the start_archive() method results in
+          an error.
+        :param Boolean hasVideo: if set to True, a video track will be inserted to the archive.
+          hasVideo is an optional parameter that is set to True by default.
 
         :rtype: The Archive object, which includes properties defining the archive,
           including the archive ID.