An object for mapping Apple TV user accounts to app-specific user preferences.


@interface TVUserManager : NSObject


A TVUserManager object improves the user experience of apps that manage their own user-specific preferences. At launch time, many apps prompt the user to select an app-specific profile. For example, video content apps use profiles to store information about which shows each user is watching and their current progress for each show. However, requiring the user to select a profile every time your app launches is cumbersome, especially for systems with only one user. The TVUserManager object provides a way for your app to select the most appropriate user profile automatically.

Create the TVUserManager object as follows:

TVUserManager* userManager = [[TVUserManager alloc] init];

When your app launches, get the currentUserIdentifier property of the user manager and use it to select an appropriate app-specific profile. You are responsible for maintaining a mapping between system users and your app's configured profiles. If the current system user doesn't have a preferred profile, display your normal profile selection interface. The first time the user selects a profile, call the shouldStorePreferenceForCurrentUserToProfile:completion: method to confirm whether the user wants to make that profile their preferred profile.

Apps should provide a way for users to change their preferred profile. When the user wants to make such a change, call the presentProfilePreferencePanelWithCurrentSettings:availableProfiles:completion: method to display the standard configuration panel.


Identifying the Current Apple TV User


A unique identifier representing the currently active Apple TV user.


A unique string for differentiating between accounts on Apple TV.

Presenting Account-Related Dialogs

- shouldStorePreferenceForCurrentUserToProfile:completion:

Prompts the user to save the specified profile as the preferred profile for the current user.

- presentProfilePreferencePanelWithCurrentSettings:availableProfiles:completion:

Presents a user-to-profile configuration panel, which lets the user specify their preferred profile.

Associating Users with a Profile


An array of system user identifiers that you associated with the current app-specific profile.


Inherits From

See Also

Multiple User Login


A model object that you use to represent an app-specific profile.

Mapping Apple TV Users to App Profiles

Adapt the content of your app for the current viewer by using TV user manager.