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, callAuthenticate
on the Beam Manager - Now wait until the Beam Manager's
AuthState
changes fromLoading
toAuthenticating
- Next, present the Beam Manager's
DeviceFlowCode.UserCode
orDeviceFlowCode.VerificationUrlComplete
to the user - Wait until the user has logged in
- Once that has happened, your
AuthState
will have changed toAuthenticated
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.