FAQ
Frequently asked questions from the Hyperbeam community
API
How do I make the browser behave as a mobile browser?
How do I make the browser behave as a mobile browser?
When creating the browser, set the user_agent field to a mobile preset,
such as {"user_agent": "chrome_android"}.
Streaming
Bandwidth requirements
Bandwidth requirements
To ensure optimal performance of Hyperbeam virtual computers, it is recommended that your users meet the following bandwidth requirements. Even though users who have less bandwidth available can still stream virtual computers, the image quality or framerate may be suboptimal.
Enabling sharp mode triples these bandwidth requirements.
Why do I need to click a 'play' button to start the stream?
Why do I need to click a 'play' button to start the stream?
Monitoring
Can I detect when a user changes the URL in the virtual browser?
Can I detect when a user changes the URL in the virtual browser?
Yes, you can detect when a user changes the virtual browser URL by using Hyperbeam’s tab event listener API available in our Web SDK. We do not currently provide a way to directly detect this action server-side.
Proxies
Is there an IP range I can use to whitelist Hyperbeam servers?
Is there an IP range I can use to whitelist Hyperbeam servers?
Not at the moment. Hyperbeam uses a variety of server providers which makes it difficult to whitelist Hyperbeam servers based on IP. You can use username/password authentication to ensure traffic originates from Hyperbeam.
Where do I put the credentials in FindProxyForURL?
Where do I put the credentials in FindProxyForURL?
Relevant MDN docs: Proxy Auto-Configuration (PAC) file
Caveats:
- Only HTTP traffic is sent through the proxy server. WebRTC traffic is excluded. Hence, there is no functional difference between the use of SOCKS, HTTP or HTTPS protocol on the proxy server.
- Authentication is not supported for SOCKS protocol. This is due to it not being implemented by Chrome.
- Due to these reasons, we recommend the usage of HTTPS to authenticate and secure communication between Hyperbeam and the proxy server: HTTPS Proxy Scheme.
Troubleshooting
My API request fails due to CORS
My API request fails due to CORS
Requests to the Hyperbeam API should not be made from the client as doing so exposes your API key to users which can easily be abused. Instead, API requests should only be made from a backend such as Vercel, Netlify or Cloudflare.