Skip to main content

FAQ

Streaming

Streaming Destination

By default the Beam Manager will try to stream to the best possible option at first. This targets the desktop client first, then the cloud.

If you want to stream to the cloud you will simply need to close the desktop client where you are logged in.

In the event that you're running multiple desktop apps on multiple machines, you can specify the computer you wish to target by simply iterating over the Beam Manager's AvailableStreamingHosts array, and then calling StartStreaming with the desired host ID as the parameter.

How Do I Manually Implement Authentication?

  • First bind your logic to the Beam Unity Events OnAuthenticationChanged event
  • Next, if you don't have Authenticate On Awake enabled, call Authenticate on the Beam Manager
  • Now wait until the Beam Manager's AuthState changes from Loading to Authenticating
  • Next, present the Beam Manager's DeviceFlowCode.UserCode or DeviceFlowCode.VerificationUrlComplete to the user
  • Wait until the user has logged in
  • Once that has happened, your AuthState will have changed to Authenticated

If your user has already previously logged in, it will simply skip straight to Authenticated on start (or when you call Authenticate)

Camera

Hiding Objects from Stream

There are two ways to hide objects from your stream, but both rely on the usage of layers.

The first way is to simply add the BeamObjectHider component to your objects you want to hide. For more information see the dedicated Object Hider page.

An alternative option that provides more control is by adjusting the Ignore Layers of your Beam Camera. It has a section called Ignore Layers where you can adjust specific layers you don't want the camera to render. This is automatically setup by default and will simply create a new layer for it to make use of. You can disable the automatic creation of this and specify these layers yourself, just turn off the Automatic Ignore Layer. You will need to select at least one of these layers to use as a "reference" layer, otherwise the BeamObjectHider and other features may unexpectedly break.

Why Does My Preview Stop When I Start Streaming / Recording / Change Camera Settings?

The Beam Camera utilises a temporary render texture when not streaming or recording. This is then swapped out as soon as you start streaming or recording so you will need to re-obtain it from the BeamCamera.RenderTexture variable.

Changing aspect ratio or resolution will cause the temporary render texture to re-created, meaning you should once again re-obtain the BeamCamera.RenderTexture variable.