Changes between Version 3 and Version 4 of Python_SIP/Media

Timestamp:

Jul 23, 2008 5:43:36 PM (16 years ago)

Author:

bennylp

Comment:

--

Python_SIP/Media

@@ -57 +57 @@
  }}}
 
+
+=== Sample: Recording to WAV File ===
+
+Or if you want to record the microphone to the WAV file, simply do this:
+
+ {{{
+#!python
+  lib.conf_connect(0, 2)
+ }}}
+
+And the media will flow from the sound device to the WAV record file, as shown in the diagram below:
+
+[[Image(conference-bridge-snd-rec.jpg)]]
+
+As usual, to stop or pause recording, just disconnect the connection:
+
+ {{{
+#!python
+  lib.conf_disconnect(0, 2)
+ }}}
+
+(Note that disconnecting the WAV recorder as above does not close the WAV file, and you can resume recording by connecting a source to the WAV recorder again.)
+
+
 === Sample: Normal Call ===
 
-For a normal call, we'd want to establish bidirectional audio with the remote person, as the diagram below shows.
+For a normal call, we'd want to establish bidirectional audio with the remote person, which can be done easily by establishing bidirectional connection between the call (with Alice, in this case) and the sound device:
+
+ {{{
+#!python
+
+ lib.conf_connect(0, 3)
+ lib.conf_connect(3, 0)
+ }}}
+
+Of course on a real application, you would replace the number "3" above with the slot number of the call, which you can get with {{{call.info().conf_slot}}}.
+
+The diagram below shows the interconnection in the bridge now:
 
 [[Image(conference-bridge-call.jpg)]]
+
+
+=== Sample: Second Call ===
+
+Suppose we want to talk with Alice and Bob at the same time. Since we already have bidirectional media connection with Alice, we just need to add the code below to establish bidirectional connection with Bob.
+
+ {{{
+#!python
+
+  lib.conf_connect(0, 4)
+  lib.conf_connect(4, 0
+ }}}
+
+Now we can talk to Alice and Bob at the same time, and we will hear audio from either party. The interconnection diagram in the bridge will be like this:
+
+[[Image(conference-bridge-2-calls.jpg)]]
+
+At this stage, we can talk to both Alice and Bob, but Alice and Bob can't talk or hear each other.
+
+=== Sample: Conference Call ===
+
+To make Alice and Bob talk to each other, just establish bidirectional media between them:
+
+ {{{
+#!python
+
+ lib.conf_connect(3, 4)
+ lib.conf_connect(4, 3)
+ }}}
+
+The snippet above will add the new connections as shown as lines with black color below:
+
+[[Image(conference-bridge-conf-call.jpg)]]
+
+
+=== Sample: Recording the Conference ===
+
+While doing the conference, it perfectly makes sense to want to record the conference to a WAV file, and all we need to do is to connect the microphone and both calls to the WAV recorder:
+
+ {{{
+#!python
+
+ lib.conf_connect(0, 2)
+ lib.conf_connect(3, 2)
+ lib.conf_connect(4, 2)
+ }}}
+
+The connections in the conference bridge now will look like the diagram below, with the snippet above adds the brown lines in the diagram:
+
+[[Image(conference-bridge-conf-call-record.jpg)]]
+