| OLD | NEW |
| (Empty) |
| 1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> | |
| 2 <html> | |
| 3 <head> | |
| 4 <title>WebRTC PeerConnection Manual Test Help Page</title> | |
| 5 <link rel="StyleSheet" type="text/css" href="stylesheet.css"> | |
| 6 <meta charset="utf-8"> | |
| 7 </head> | |
| 8 <body> | |
| 9 | |
| 10 <h1>WebRTC PeerConnection Manual Test Help Page</h1> | |
| 11 <p> | |
| 12 The test page is intended for testing WebRTC calls. | |
| 13 | |
| 14 This is how you set up a normal call: | |
| 15 </p> | |
| 16 <ol> | |
| 17 <li>Open this page in two tabs.</li> | |
| 18 <li>Start the peerconnection server. Click on the question mark next | |
| 19 to the 'server' field for instruction on how to do that. The easiest | |
| 20 thing is to start it on localhost, but you can start it on any | |
| 21 machine you like and connect to hostname:8888.</li> | |
| 22 <li>Click the Connect button in both tabs.</li> | |
| 23 <li>Click the Call:Negotiate button in one of the tabs. You should see a bunch | |
| 24 of printouts when this happens. Note that no streams are sent to | |
| 25 begin with (although you could run steps 5-6 before this step to get streams | |
| 26 even in the initial call).</li> | |
| 27 <li>Grant media access using the checkboxes and Request button.</li> | |
| 28 <li>Add the local stream by clicking the "Add" button, in both tabs.</li> | |
| 29 <li>Now you must re-negotiate the call by clicking on Negotiate again.</li> | |
| 30 <li>You should now have a call up and both sides should be receiving | |
| 31 media data (depending on what access you granted on the respective | |
| 32 pages).</li> | |
| 33 <li>You can now choose to stop, re-request, re-send or disable streams | |
| 34 in any way you like, or hang up and re-start the call. You don't | |
| 35 need to disconnect: that's done automatically when you close the | |
| 36 page. Hanging up is NOT done automatically though.</li> | |
| 37 </ol> | |
| 38 | |
| 39 <p> | |
| 40 To create a data channel: | |
| 41 </p> | |
| 42 <ol> | |
| 43 <li>Make sure Chrome is started with the --enable-data-channels flag.</li> | |
| 44 <li>Follow the instructions above to connect two tabs to a | |
| 45 peerconnection_server.</li> | |
| 46 <li>Click the Data channel: Create button in one tab. Notice the status | |
| 47 changes to "connecting".</li> | |
| 48 <li>Click the Call:Negotiate button. You should see the status change to | |
| 49 "open" in both tabs. </li> | |
| 50 <li>Enter text in the textbox next to the Send data button and then click Send | |
| 51 data. Notice the text is received in the remote tab in the Received on data | |
| 52 channel text box. Data can be sent in both direct.</li> | |
| 53 <li>To close the channel press the Close button followed by Negotiate. Notice | |
| 54 the status change to "closed"</li> | |
| 55 </ol> | |
| 56 | |
| 57 <p>Detailed descriptions:</p> | |
| 58 <ul> | |
| 59 <li>Connect - once a connection is established, you generally won't | |
| 60 need to click this button again. Connecting really isn't something | |
| 61 related to WebRTC as such, it's just the signalling solution.</li> | |
| 62 <li>Note that if more than two users/machines have established a | |
| 63 connection to the same PC server, you will get an error when | |
| 64 pressing this button. The test is hard-coded to only allow 2 peers | |
| 65 on the server at the same time.</li> | |
| 66 <li>Pressing the Add button for local streams will in effect add | |
| 67 the current local stream, such as it is, to the current | |
| 68 peerconnection.</li> | |
| 69 <li>If you request user media again, it will overwrite the current | |
| 70 local stream with the new one. This means that pressing Add will | |
| 71 add the stream you just got from the request. The code will not | |
| 72 attempt to stop or remove the previous stream from the | |
| 73 peerconnection, so depending on peerconnection's semantics the old | |
| 74 stream will remain with the peerconnection (perhaps the streams will | |
| 75 be sent simultaneously?)</li> | |
| 76 <li>Hang Up will clear away peer connections on both sides, and a new | |
| 77 call can be started if desired. The peers remain connected to the | |
| 78 peerconnection server.</li> | |
| 79 <li>The Toggle buttons will set the .enabled properties on the first | |
| 80 video and audio track for the local or remote stream, respectively. | |
| 81 This is effectively a temporary "mute" for the streams.</li> | |
| 82 <li>Stop terminates a stream, which means it will no longer send any | |
| 83 more data.</li> | |
| 84 <li>Remove will remove the current local stream from the current | |
| 85 peerconnection. For instance, you should be able to send a stream, | |
| 86 remove it, re-request a new stream and send that within the same | |
| 87 call. Note that re-requesting user media overwrites the current | |
| 88 media stream, so the reverse is not possible.</li> | |
| 89 <li>The PeerConnection constraints field can pass in constraints for the | |
| 90 peerconnection to be established. The code will attempt to eval the code | |
| 91 you write in and pass it whenever the code asks for constraints. | |
| 92 [experimental]</li> | |
| 93 <li>The Force Opus checkbox will remove all codecs except OPUS for all | |
| 94 outgoing messages sent by this page. Note that this ONLY means that | |
| 95 we are guaranteed to send Opus to the other side; it does NOT mean | |
| 96 that the other side will necessarily send Opus to us. To do that, | |
| 97 you need to check the box on the other side too. You can either | |
| 98 check the box before the call, or check the box and then re-send the | |
| 99 local stream.</li> | |
| 100 </ul> | |
| 101 | |
| 102 | |
| 103 | |
| 104 </body> | |
| 105 </html> | |
| OLD | NEW |