Prior to hosting a session with integrated video on Handshake, we recommend reviewing the requirements included in this resource, adjusting your setup as needed, then testing your setup using our Handshake Video Test.
Topics:
- System setup and settings minimum requirements
- Mac system requirements for screen sharing
- Windows 10 required settings for camera and mic
- Required firewall and network settings
System setup and settings minimum requirements
- An internet connection – broadband wired or wireless (3G or 4G/LTE)
- Speakers and a microphone – built-in or USB plug-in or wireless Bluetooth
-
**Optional, but required if you'd like to use video: A webcam or HD webcam - built-in or USB plug-in
- Tip: If you're using a webcam that isn't built in to your device, make sure any additional permissions/settings are configured prior to your scheduled virtual interaction!
- Desktop or laptop computer – mobile devices (smart phones and tablets, e.g. iPads) are only supported for students using our mobile app on iOS and Android.
-
Modern desktop web browser which supports WebRTC – make sure pop-ups are allowed in the browser!
- We support the latest versions of:
- Chrome
- Safari – users are limited to sharing the full screen and cannot choose individual apps/browser windows, etc.
- Firefox
- MS Edge – older, non-Chromium versions of Microsoft Edge (versions less than 79) do not support screen sharing capabilities
- Each browser has it's own security and privacy settings that may require you granting permission for the microphone and camera to be used by Handshake.
- We support the latest versions of:
Note: Hosts may be able to launch sessions via mobile web (via smart phone or tablet, e.g. iPad) successfully, however, this is not officially supported by Handshake and has several limitations:
- On any mobile web access, hosts are unable to share their screen.
- On iOS devices, hosts will only be able to use Safari, as Apple does not allow third party browsers access to the device camera or microphone.
- On Android devices, the camera and microphone should be able to be accessed by any browser.
Mac system requirements for screen sharing
To share a screen or window on a Mac, you must give each specific browser or app permission.
1. Open System Preferences, then select Security & Privacy.
2. Click the lock in the lower-right corner to authenticate for changes.
3. Select the Privacy tab, select Screen Recording, then check the box for the desired browser.
If the browser is open when you change this setting, you will need to quit and reopen the browser for the changes to take effect.
Windows 10 required settings for camera and mic
Windows has its own privacy settings for microphone & camera that are independent of the browser. By default in most cases this is turned off.
There are two settings pages:
- Settings > Privacy > Microphone
- Settings > Privacy > Camera
Both pages have two toggles:
- Allow apps to use my microphone/camera (used for built-in Microsoft apps from their app store)
- Allow desktop apps to use my microphone/camera (used for things like browsers and Zoom)
The second toggle (for desktop apps) can only be enabled if the first is enabled, so you will need to turn both toggles on in both places for your browser to be able to access their mic and camera.
Required firewall and network settings
These domains should be unblocked:
Browsers must communicate with Twilio’s cloud, in addition to the standard Handshake domains. The following hosts, ports/protocols and IP ranges are required:
Host Name / IP Range |
Port and Protocol |
global.vss.twilio.com |
443 WSS |
us1.vss.twilio.com |
443 WSS |
us2.vss.twilio.com |
443 WSS |
ie1.vss.twilio.com (UK) |
443 WSS |
global.vss.twilio.com |
443 WSS |
34.203.254.0 - 34.203.254.255 54.172.60.0 - 54.172.61.255 34.203.250.0 - 34.203.251.255 3.235.111.128 - 3.235.111.255 |
10,000 - 60,000 UDP/SRTP/SRTCP |
34.216.110.128 - 34.216.110.159 54.244.51.0 - 54.244.51.255 44.234.69.0 - 44.234.69.127 |
10,000 - 60,000 UDP/SRTP/SRTCP |
(UK) 52.215.253.0 - 52.215.253.63 54.171.127.192 - 54.171.127.255 52.215.127.0 - 52.215.127.255 3.249.63.128 - 3.249.63.255 |
10,000 - 60,000 UDP/SRTP/SRTCP |
Additionally, browsers should be able to connect to the services at the following hostnames:
- sdkgw.us1.twilio.com (WSS/443)
- endpoint.twilio.com
- mobile-endpoint.twilio.com
Comments
0 comments
Article is closed for comments.