Skip to content
This repository has been archived by the owner on Sep 9, 2024. It is now read-only.

Commit

Permalink
Merge pull request #394 from DolbyIO/mac_updates
Browse files Browse the repository at this point in the history
Mac UE 5.3 permissions doc update
  • Loading branch information
Kuba Audykowicz authored Sep 11, 2023
2 parents 4c51ed3 + 12570c3 commit 812da2c
Showing 1 changed file with 5 additions and 3 deletions.
8 changes: 5 additions & 3 deletions docs/docs/tutorial/obtain-permissions.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,20 +4,22 @@ sidebar_label: macOS Permissions
title: macOS Permissions
---

## Unreal Engine 5.1 and earlier
## Unreal Editor

Using the plugin in the Unreal Editor requires the editor to obtain microphone and camera permissions, however:
- On Unreal Engine 5.0 and earlier, the editor is not packaged correctly to ask for either permission.
- On Unreal Engine 5.1, the editor is not packaged correctly to ask for the camera permission.
- On Unreal Engine 5.2, the editor is packaged correctly to ask for both permissions.
- On Unreal Engine 5.3, the editor is again not packaged correctly to ask for either permission.

Therefore, you need to forcefully provide these permissions to the editors and possibly the Epic Games Launcher. To do so, you can use the [tccutil](https://github.com/DocSystem/tccutil) permissions manager and the following commands:
Therefore, you may need to forcefully provide these permissions to the editors and possibly the Epic Games Launcher. To do so, you can use the [tccutil](https://github.com/DocSystem/tccutil) permissions manager and the following commands:
- 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`
- Epic Games Launcher: `sudo python tccutil.py -e -id com.epicgames.EpicGamesLauncher --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.

## All Unreal Engines
## Packaging games

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:

Expand Down

0 comments on commit 812da2c

Please sign in to comment.