1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
#!/usr/bin/env python
# Copyright (c) 2012 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
import os
import subprocess
import pyauto
class MissingRequiredBinaryException(Exception):
pass
class WebrtcTestBase(pyauto.PyUITest):
"""This base class provides helpers for WebRTC calls."""
def ExtraChromeFlags(self):
"""Adds flags to the Chrome command line."""
extra_flags = ['--enable-media-stream', '--enable-peer-connection']
return pyauto.PyUITest.ExtraChromeFlags(self) + extra_flags
def GetUserMedia(self, tab_index, action='allow'):
"""Acquires webcam or mic for one tab and returns the result.
Args:
tab_index: The tab to request user media on.
action: The action to take on the info bar. Can be 'allow', 'deny' or
'dismiss'.
Returns:
A string as specified by the getUserMedia javascript function.
"""
self.assertEquals('ok-requested', self.ExecuteJavascript(
'getUserMedia("{ audio: true, video: true, }")', tab_index=tab_index))
self.WaitForInfobarCount(1, tab_index=tab_index)
self.PerformActionOnInfobar(action, infobar_index=0, tab_index=tab_index)
self.WaitForGetUserMediaResult(tab_index=0)
result = self.GetUserMediaResult(tab_index=0)
self.AssertNoFailures(tab_index)
return result
def WaitForGetUserMediaResult(self, tab_index):
"""Waits until WebRTC has responded to a getUserMedia query.
Fails an assert if WebRTC doesn't respond within the default timeout.
Args:
tab_index: the tab to query.
"""
def HasResult():
return self.GetUserMediaResult(tab_index) != 'not-called-yet'
self.assertTrue(self.WaitUntil(HasResult),
msg='Timed out while waiting for getUserMedia callback.')
def GetUserMediaResult(self, tab_index):
"""Retrieves WebRTC's answer to a user media query.
Args:
tab_index: the tab to query.
Returns:
Specified in obtainGetUserMediaResult() in getusermedia.js.
"""
return self.ExecuteJavascript(
'obtainGetUserMediaResult()', tab_index=tab_index)
def AssertNoFailures(self, tab_index):
"""Ensures the javascript hasn't registered any asynchronous errors.
Args:
tab_index: The tab to check.
"""
self.assertEquals('ok-no-errors', self.ExecuteJavascript(
'getAnyTestFailures()', tab_index=tab_index))
def Connect(self, user_name, tab_index):
self.assertEquals('ok-connected', self.ExecuteJavascript(
'connect("http://localhost:8888", "%s")' % user_name,
tab_index=tab_index))
self.AssertNoFailures(tab_index)
def EstablishCall(self, from_tab_with_index, to_tab_with_index):
self.WaitUntilPeerConnects(tab_index=from_tab_with_index)
self.assertEquals('ok-peerconnection-created', self.ExecuteJavascript(
'preparePeerConnection()', tab_index=from_tab_with_index))
self.AssertNoFailures(from_tab_with_index)
self.assertEquals('ok-added', self.ExecuteJavascript(
'addLocalStream()', tab_index=from_tab_with_index))
self.AssertNoFailures(from_tab_with_index)
self.assertEquals('ok-negotiating', self.ExecuteJavascript(
'negotiateCall()', tab_index=from_tab_with_index))
self.AssertNoFailures(from_tab_with_index)
self.WaitUntilReadyState(ready_state='active',
tab_index=from_tab_with_index)
# Double-check the call reached the other side.
self.WaitUntilReadyState(ready_state='active',
tab_index=to_tab_with_index)
def HangUp(self, from_tab_with_index):
self.assertEquals('ok-call-hung-up', self.ExecuteJavascript(
'hangUp()', tab_index=from_tab_with_index))
self.WaitUntilHangUpVerified(tab_index=from_tab_with_index)
self.AssertNoFailures(tab_index=from_tab_with_index)
def WaitUntilPeerConnects(self, tab_index):
peer_connected = self.WaitUntil(
function=lambda: self.ExecuteJavascript('remotePeerIsConnected()',
tab_index=tab_index),
expect_retval='peer-connected')
self.assertTrue(peer_connected,
msg='Timed out while waiting for peer to connect.')
def WaitUntilReadyState(self, ready_state, tab_index):
got_ready_state = self.WaitUntil(
function=lambda: self.ExecuteJavascript('getPeerConnectionReadyState()',
tab_index=tab_index),
expect_retval=ready_state)
self.assertTrue(got_ready_state,
msg=('Timed out while waiting for peer connection ready '
'state to change to %s for tab %d.' % (ready_state,
tab_index)))
def WaitUntilHangUpVerified(self, tab_index):
self.WaitUntilReadyState('no-peer-connection', tab_index=tab_index)
def Disconnect(self, tab_index):
self.assertEquals('ok-disconnected', self.ExecuteJavascript(
'disconnect()', tab_index=tab_index))
def BinPathForPlatform(self, path):
"""Form a platform specific path to a binary.
Args:
path(string): The path to the binary without an extension.
Return:
(string): The platform-specific bin path.
"""
if self.IsWin():
path += '.exe'
return path
def StartPeerConnectionServer(self):
"""Starts peerconnection_server.
Peerconnection_server is a custom binary allowing two WebRTC clients to find
each other. For more details, see the source code which is available at the
site http://code.google.com/p/libjingle/source/browse/ (make sure to browse
to trunk/talk/examples/peerconnection/server).
"""
# Start the peerconnection_server. It should be next to chrome.
binary_path = os.path.join(self.BrowserPath(), 'peerconnection_server')
binary_path = self.BinPathForPlatform(binary_path)
if not os.path.exists(binary_path):
raise MissingRequiredBinaryException(
'Could not locate peerconnection_server. Have you built the '
'peerconnection_server target? We expect to have a '
'peerconnection_server binary next to the chrome binary.')
self._server_process = subprocess.Popen(binary_path)
def StopPeerConnectionServer(self):
"""Stops the peerconnection_server."""
assert self._server_process
self._server_process.kill()
|
