Version: 2019.2
Apple TV
tvOS build settings

Apple TV

このマニュアルページは、 iOS から tvOS への移植を手助けすることを主眼においています。Apple TV プラットホーム(tvOS)は、 iOS プラットホームの設立時に構想され、ゲーム開発者に新しいパラダイムと挑戦をもたらしました。すでにモバイル用のゲームがあるなら、ワンクリックするだけで tvOS に配信できますが、Unityのインプット制御で正しく動作するようにゲームを改造したり、大きなテレビ画面でプレイされる事を考慮しなければいけなくなる事があります。

前提条件

tvOS向けの開発には、以下のものが必要です。

  • 第 4 世代の Apple TV 機器。 ( USB C <-> USB 3.0 ケーブルも必要です。これは、一般販売パッケージには含まれていません )
  • Xcode 7.1 以降のバージョン。
  • iOS 端末と同じ方法で、デバイスにプロビジョニングを設定する必要があります。まずは Xcode を使って空の tvOS アプリを作成し、プロビジョニングが正しく動くかどうかテストすることをお勧めします。

開発前に知っておくこと

  • 多くの iOS プラグインは、iOS フレームワークのサブセットしかサポートしていないため、 Apple TV とは互換性がありません。Apple TV 用に、ゲームのブランチかコピーを別に用意して、そこに移植することをお勧めします。プラグイン提供者にプラグインのアップデートを依頼することを忘れないようにしてください。
  • If your game uses more than 4 GB on disk, you should break it into smaller parts and use On Demand Resources. For On Demand Resources support in Unity please refer to the On Demand Resources section below. Note that Bitcode is included with tvOS builds, which adds ~130 MB to your executables. This added size is not accounted for in distribution size, as it is be stripped by App Store servers. You can estimate Bitcode size by analyzing LLVM sections in your executable from the command line with otool -l.

入力の実装

Apple TV Remote (Siri Remote) は、古典的なメニューによる操作、ゲームコントローラー、ジャイロと加速度センサー、タッチジェスチャーデバイス等で使う事ができる、多目的の入力デバイスです。 TV Remote での入力は、 Unity で最小限の処理が行われ、大抵は Unity の API と連携します。

一般的に、どんなゲームでも Apple TV Remote の独特な入力機能を効果的に使うため、入力方法に多少の調整が必要になります。あるゲームでは、アナログスティックと複数のアクションボタンを持つ古典的なゲームコントローラーのように扱うのが一番効果的かもしれません。中には、加速度センサーをステアリングに使うのがよいゲームもあるでしょう。 tvOS にゲームを配信するときには、いくつかの方法を試してみた方がよいです。

特定の TV Remote の機能にアクセス方法の技術的な詳細を説明します。

  • NFi 認証のゲームコントローラーサポートをまだゲームに組み込んでいない場合は、iOS Game Controller への対応 を参照してください。Unity エディターのカスタムアクションマッピングを設定して (Edit > Project Settings に移動し、Input を選択)、リストにあるマッピングを使ってください。
  • Apple TV Remote のタッチエリアは Input.touches (Touch.typeIndirect に設定され、 Unity GUI からは無視されます) と、 Input.GetAxis("Horizontal"); などのジョイスティック入力の API 両方にマップされます。
  • Remote の加速度とジャイロは、それぞれ Input.accelerationInput.gyro にマップされます。 Input.acceleration は内部的にはジャイロの API から提供されているので、やや不安定かもしれません。残念ながら tvOS SDK には、加速度専用の API はありません。 Input.gyro.attitude は重力ベクトルを元にしており、そのため、重力ベクトルと平行な軸周りの回転はありません。 Input.gyro.rotationRate も同様です。
  • リモコンの Pause/Play ボタンは “X” ボタンにマップされます (その後、 joystick button 15 にマップされます)。
  • Apple TV の Remote のタッチエリアのクリックは、 “A” ボタンにマップされます (その後、 joystick button 14 にマップされます)。
  • このデバイスのメニューボタンは、独特の動作をします。長押しすると、タスク切り替えが呼び出されます。この動作は変更することができません。短く押した場合には、 2 種類の処理があります。
    • a) システムのホーム画面を実行する (UnityEngine.Apple.TV.Remote.allowExitToHometrue の場合)
    • b) UnityEngine.Apple.TV.Remote.allowExitToHomefalse のときに、アプリをタップに反応させます (“Pause” / joystick button 0) にマップされます)。これがデフォルトの挙動となります。
    • アプリケーションは、現在の状態に基づいて a)b) との間で切り替えをします。ユーザーがトップメニューを操作するとき、 a) のビヘイビアを有効にします。リアルタイムでゲームを操作している場合は b) のビヘイビアを有効にし、このボタンが押されるとインゲームのポーズメニューを起動します。
  • Apple TV remote では、リモコンのフチをスワイプすることによって、デジタルパッドの上下左右も入力できます。マッピングに関しては Unity マニュアルの iOS Game Controller への対応 ページを参照してください。
  • Apple TV remote の操作モードは、専用の API から制御できます。
    • UnityEngine.Apple.TV.Remote.allowExitToHome
    • UnityEngine.Apple.TV.Remote.allowRemoteRotation
    • UnityEngine.Apple.TV.Remote.reportAbsoluteDpadValues
    • UnityEngine.Apple.TV.Remote.touchesEnabled
  • Apple TV box をゲーム機にして、さらに 2 台のワイヤレス MFi ゲームコントローラーを接続することができます。 Apple TV Remote 単体でプレイ可能なゲームだったとしても、iOS MFi コントローラーと同じ方法(前述した方法)で、ゲームから利用することができます。今のところ、追加できるコントローラーの数は 2 台までです。これは、確認されている tvOS システムの制限のためです。

注意: UnityEngine.Apple.TV.Remote.allowExitToHomefalse に設定され、デフォルト 入力 ウィンドウが Submit バーチャルボタン (joystick button 0 にマッピングされています) にバインドされている場合、Apple TV Remote の Menu ボタンも同じく joystick button 0 と認識されるため、Menu ボタンを押すと、UI エレメント上でアクションをトリガーします。この問題を回避するには、入力 ウィンドウで Submit バーチャルボタンバインディングを削除するか、変更する必要があります。

TV Remote を使った Unity GUI 操作の設定

  • Unity エディターで Input Manager を開きます。最初の Submit 仮想入力 (virtual input) を見つけてそれを開き、Alt Positive Buttonjoystick button 14 に変更します。

  • シーン内で EventSystem ゲームオブジェクトを選択します。インスペクターで、EventSystem コンポーネントを見つけ、最初のフォーカスを受ける UI ゲームオブジェクトへの参照を First Selected プロパティーに設定します。Standalone Input Module コンポーネントの Force input module プロパティーを有効にする必要があるかもしれません。

  • すべてが正しく行われると、エディター実行中であれば UI をキーボードから操作できるようになり、デバイス実行中には TV Remote のスワイプとクリックで UI を操作できるようになります。

注意: TV Remote による操作は、 TV Simulator では機能しません。

Xcode プロジェクトにリーダーボードを追加

ゲームセンターでは、ネイティブのリーダーボードの UI に提供するカスタムビジュアルリソースが必要です。ここでは、 Xcode にリソースを追加する方法を簡単に説明します。

  • Xcode プロジェクトで Images.xcassets を選択します。
  • ファイルリストで右クリックして、メニューから Game Center > New AppleTV Leaderboard を選択します。
  • ここに画像を追加します。
  • リーダーボード を選択して右側にある Edit View を選択します。Identifier プロパティーを選択して、リーダーボードのIDを入力します。
  • 今までの設定作業をした後に、アセットのコンパイルが失敗し始めたときは、 Xcode の “Build Settings” にある “On Demand Resources” を無効にしてください。

オンデマンドリソースサポートの実装

tvOS has requirements on how much disk space your application can reserve. The main application installation bundle size can not exceed 4 GB. The limits for additional downloadable content are up to 2GB for in-use assets and up to 20GB of total downloadable content. Apple recommends On Demand Resources (ODR) for tvOS downloadable content, as it enables the best disk space management strategies for tvOS. Unity supports ODR via Asset Bundles. An ODR implementation guide can be found in our dedicated blogpost on the subject.

既知の制限

  • オンスクリーンキーボードには、入力欄が 1 行しかありません。
  • tvOS Simulator では TV Remote をゲームコントローラーとしてエミュレートしないので、入力してもゲームにアクセスできません。
Apple TV
tvOS build settings