PayloadKit

TV Remote

com.apple.tvremote

The payload that configures the Apple TV remote.

iOS 11.3+tvOS 11.3+
Apple schemaexclusive

Requires supervision on iOS, tvOS · Only one instance per profile

Configuration Keys (2)

KeyTypeDescriptionDefaultRange
AllowedRemotesarray

Allowed Remotes

not on iOS

arrayThe array of valid devices that Apple TV can connect to.Default: —Range: —
AllowedRemotesItemdict

Allowed Remotes Content Item

required
dictThe array of valid devices that Apple TV can connect to.Default: —Range: —
RemoteDeviceIDstring

Remote Device ID

required
stringThe MAC address of a permitted iOS device that can control this Apple TV. Use the format 'xx:xx:xx:xx:xx:xx', which isn't case-sensitive.Default: —Range: —
AllowedTVsarray

Allowed TVs

not on tvOS

arrayThe array of valid Apple TV identifiers that the remote can connect to.Default: —Range: —
AllowedTVsItemdict

Allowed TVs Content Item

required
dictThe array of valid Apple TV identifiers that the remote can connect to.Default: —Range: —
TVDeviceIDstring

TV Device ID

required
stringThe MAC address of an Apple TV device that the system permits this iOS device to control. Use the format 'xx:xx:xx:xx:xx:xx', which isn't case-sensitive.Default: —Range: —
TVDeviceNamestring

TV Device Name

iOS 15.0+

stringThe name of an Apple TV device that the system permits this iOS device to control.Default: —Range: —