Before you start
The currently supported platforms are Windows, Mac OS X, and Linux.
Getting the code and building
Create a working directory, enter it, and run:
$ gclient config http://libjingle.googlecode.com/svn/trunk
$ gclient sync --force
If you instead want to get the latest trunk without the peerconnection and its sample client and server, use:
$ gclient config http://webrtc.googlecode.com/svn/trunk
If you're a committer, substitute https for http. On Windows, use gclient.bat instead (or prefix the commands by invoking python).
On Linux, ensure your dependencies are up to date, as described on the prerequisites
The sync will generate native build files for your environment using gyp
(Linux: make, OS X: XCode, Windows: Visual Studio). This generation can also be forced manually:
$ gclient runhooks --force
On Windows, gyp will use the latest Visual Studio on your system by default. In order to specify a particular Visual Studio version, there are a few options. You can set an environment variable
GYP_MSVS_VERSION=<version> before runhooks, or manually run the gyp command triggered by runhooks. From the trunk/ directory:
$ build/gyp_chromium --depth=. -G msvs_version=<version> talk/libjingle_all.gyp
where <version> is, for example, 2008.
You should now be able to build the sample programs peerconnection_client (Windows and Linux only) and peerconnection_server (Windows, Linux, Mac).
The sample application creates a simple video chat client and server, using the WebRTC Native API
$ cd trunk
$ make peerconnection_server
$ make peerconnection_client
Use Visual Studio to open and build the trunk/talk/libjingle_all.sln solution file. This will build both
$ cd trunk
$ open talk/libjingle_all.xcodeproj/
This will open XCode. You can build the
target using XCode. Note that currently we don't have the peerconnection_client for Mac.
It is also possible to use regular Make to build. To do this, set the environment variable
(in bash, type
) and then run
. With this, you can for instance import the project into Eclipse as a makefile project and use that instead of XCode.
How to Run
The resulting binaries appear in
xcodebuild/Debug/ on Mac,
out/Debug/ on Linux and
build/Debug/ on Windows.
Once built, start the
peerconnection_server application. This is a simple web server that's built to exchange signaling messages between instances of
peerconnection_client (Note: the client for Windows and Linux only).
You can also use the test HTML page (trunk/talk/examples/peerconnection/server/server_test.html) to connect to the server and enable loopback when you've only got one instance of
peerconnection_client running. Enabling loopback causes the client to set up a video/voice session with itself.
When the server is running, you'll see a message indicating that it is running:
Server listening on port 8888
peerconnection_client. This is a client application that uses the PeerConnection C++ API for setting up a video+voice session with a remote peer. The application uses the server to send signaling messages (messages generated by the API) between the peers.
The UI of the application consists of these three parts:
- Connect to server. Here you specify the machine that is currently running the server. Hit "Connect" or press return.
- Select peer. When you've connected with the server, you'll see a list of other
peerconnection_client instances (or
server_test.html) that are currently connected. To connect with a peer, double click or select+press return. This will start the local capture components (mic+webcam) as well as exchange signaling messages with the peer via the server. You can verify this via the server console.
- Video chat. When the signalling messages have been exchanged, the PeerConnection API creates channels for the voice and video streams and you will see the remote video in full window.
To end a chat session and go back to selecting a peer, press Esc. To disconnect from the server and go back to the initial UI, press Esc again.
On Mac, Linux
trunk/talk/examples/peerconnection/server/server_test.html. Click connect. Observe that the peerconnection_server announces your connection. Now you can open one more tab with the page, connect that too (with a different name) and send messages between the peers.
Building for Android (on Linux)
1. Check out as usual:
gclient config https://webrtc.googlecode.com/svn/trunk
2. Generate makefiles:
4. Build WebRTCDemo
ant debug install