Skip to main content

macOS Permissions

NOTE: macOS only - ignore this section if you are developing on Windows.

Using the plugin in the Unreal Editor requires the editor to obtain microphone and camera permissions. However, on macOS the editor never asks for permissions, so you need to forcefully provide them to your application. To do so, you can use the tccutil permissions manager and the following commands:

  • Epic Games Launcher: sudo python tccutil.py -e -id com.epicgames.EpicGamesLauncher --microphone --camera
  • Unreal Engine 4: sudo python tccutil.py -e -id com.epicgames.UE4Editor --microphone --camera
  • Unreal Engine 5: sudo python tccutil.py -e -id com.epicgames.UnrealEditor --microphone --camera

The mentioned permissions manager is not endorsed by Dolby in any way and may be dangerous as it needs root permissions to access sensitive system files and requires you to grant full disk access to the terminal. If you do not wish to use it, you need to find another way to provide the required permissions to the Unreal Editor. Otherwise, you need to package the game to use the plugin and cannot test it in the editor. In order to package games using the plugin with the data required to request the necessary permissions, you need to add the following lines to your game's Info.plist file, or, if you want to automatically add these lines to all your packaged games, to the {UnrealEngineRoot}/Engine/Source/Runtime/Launch/Resources/Mac/Info.plist file:

<key>NSMicrophoneUsageDescription</key>
<string>Dolby.io Virtual Worlds</string>
<key>NSCameraUsageDescription</key>
<string>Dolby.io Virtual Worlds</string>

We recommend the latter solution if it does not conflict with your setup because the Info.plist file is overwritten each time the game is packaged.