What is option for Game Controller Required?

App & System Services Core OS
dungnx OP
Created Jul ’16
Replies 9
Boosts 0
Views 4.3k
Participants 5

Since tvOS 10 beta, Siri remote support is not required and the game can require the use of a game controller to play the game. Is there a available option specifying that requirement? Does the GCSupportedGameControllers option with only ExtendedGamepad (without MicroGamepad) in .plist satisfy that:

<key>GCSupportedGameControllers</key>
<array>
    <dict>
      <key>ProfileName</key>
      <string>ExtendedGamepad</string>
    </dict>
  </array>
<key>GCSupportsControllerUserInteraction</key>
<true/>

In the game code, do we still need to write our own code to warn user if he's playing the game without game controllers connected as well as ignore input events from Siri remotes?

Replies  9
Boosts  0
Views  4.3k
Participants  5
OP
Apple
Jul ’16

To require a game controller for your app, set GCSupportsControllerUserInteraction = NO in your application plist.


The system will warn the user if the game being downloaded/purchased uses (requires) a Game Controller but a Game Controller is not present. There is also a "Game Controller Required" UI in the App Store page for an app in this scenario.

0
PegasoneInc OP
Aug ’16

Hi, can you please post a link for additional info? This one doesn't seem very intuitive to me... I don't suppose this would work unless the app is built for tvOS 10 beta? My last update was built for tvOS 9.2.2 and supports both the remote and MFi GC, however it got rejected at first simply because I had inserted a sentence in the description saying that a GC was required (btw, the policy update on the GC requirement is posted in the public docs, albeit being tagged "beta").

0
OP
Apple
Sep ’16

There is a checkbox in Xcode 8 to choose whether or not to require a game controller under the Capabilties tab. Please see https://developer.apple.com/videos/play/wwdc2016/607/ for more details.

0
PegasoneInc OP
Oct ’16

The key GCSupportsControllerUserInteraction seems to be publicly undocumented at this time. Actually, the entire documentatiin for tvOS 10 seems to he missing, both in Xcode 8 and online. I edited the key as you suggested and submitted my app update for tvOS 10+. In "Notes to Review", I explained that I have no idea what this key does but I that want to require a GC, and in my app description the requirement is now highlighted, despite its support both for the GC and for the Siri Remote. The app update got approved. Now, when I download or launch the app on the device, and a GC is not connected to it, there is no warning whatsoever for the user regarding a requirement for a GC. I am thinking that it may not be implemented yet and that we may have have to wait for an OS update for clarification. If anyone had a different experience please share. Thanks.

0
Technology Evangelist OP
Apple
Oct ’16

If you are building your app with Xcode 8 and linking with the tvOS 10 SDK, then here's how to require a game controller:

  1. Go to the "Capabilities" tab in Xcode and turn on the "Game Controllers" switch.
  2. Check the box for "Extended Gamepad". That's saying you support a game controller.
  3. Un-check (or leave blank) the box for "Micro Gamepad". That's saying you don't support the Siri Remote.


Then rebuild/test/submit your app.


If you are building your app with Xcode 7.x and/or linking with the tvOS 9 SDK, then you would need to do the above steps plus manually set the GCSupportsControllerUserInteraction key to false in your info.plist. Better to just upgrade and link with the tvOS 10 SDK as above.


Once these are set, then the app store should display some "Game Controller Required" text on your store page, next to the price. Then during a purchase, if someone has -never- paired a game controller with their Apple TV and goes to buy the game, they'll be shown an alert "Requires a Game Controller" with some descriptive text and Continue / Cancel buttons. If they had previously paired a controller to this Apple TV this alert won't be shown.


It's still up to you to present UI in-game instructing the player to connect a controller if you detect no game controller is connected (right now). For example, if the player uses the Siri Remote to launch the game and hasn't woken up their game controller yet, or the controller goes out of range, gets turned off, etc.

0
OP
Apple
Oct ’16

You should be able to just set the checkbox as documented in the above video/PDF and the correct key will be set.

0
PegasoneInc OP
Oct ’16

@funnest and @BTH -- OK guys, I followed your suggestions and it does work, the app update for tvOS 10 requiring a GC has been approved today, so a big Thank You! to both of you 🙂 For everybody else, just be advised that unchecking Micro Gamepad in Xcode under Capabilities does not prevent the detection of the Siri Remote, therefore your ExtendedGamepad can show either under controller[0] or controller[1] upon hardware change. Cheers!

0
Dakic OP
Sep ’22

Hey,my name is daniel,i want to dowloand iOS 16 on iphone 7+ bye.😊

0
Dakic OP
Sep ’22

Hey my name is Daniel,I am from Serbia, Belgrade.I sow on TikTok all people have iOS16 on his phones.But i can’t.Because i Dowloand iOS 15.7,I want iOS16😕

0
What is option for Game Controller Required?
First post date Last post date
 
 
Q