iOS 開発者ガイド for SDK

LiveSight

LiveSight を使用すると、リアルワールドをインターフェイスとして使用するユーザーエクスペリエンスを利用できます。 LiveSight を使用すると、開発者はデバイスカメラを使用して表示されている実世界の地理空間コンテンツをオーバーレイできます。 さらに、デバイスセンサーを使用して空間内の動きを追跡し、それに応じてビューを更新することで、イマーシブエクスペリエンスが作成されます。

このセクションで説明する主な概念に は、 iOS アプリケーションへの LiveSight の追加、カメラモードでの LiveSight の開始、 LiveSight のエクスペリエンスのカスタマイズが含まれます。 対象となるクラスに NMACompositeView は、およびが含ま NMAARControllerれます。

LiveSight で は、 iOS ユーザーがバックカメラへのアプリケーションのアクセス権を付与する必要があります。 カメラが利用できない場合 は、 LiveSight の起動時にNMAARErrorCameraAccessNotAuthorizedエラーコードが返されます。

NMACompositeView

LiveSight 機能に関連するUIViewサブクラスはNMACompositeViewです 。NMACompositeViewは、 1 つの iOS UI コンポーネントで LiveSight 機能を公開します。 このセクションの以降の部分で NMACompositeView は、コードサンプルおよびディスカッションで使用します。

メモ :NMACompositeView はマップ ビューをサポートしていません。 そのため、複合ビューは LiveSight のみをサポート し、 LiveSight が開始されるまで黒い画面としてレンダリングされます。 今後 NMACompositeView のリリースでは、マップ ビューとカメラビューの併用のサポートがに追加される予定です。

NMACompositeView の追加と初期化

LiveSight 機能をアプリケーションに統合する最初の手順 は、NMACompositeViewをビューレイアウトに挿入することです。 これを行う には、現在の iOS ビューにNMACompositeViewサブビューを追加します。

UIView のオブジェクトと同様 NMACompositeViewinitWithFrame: に、メソッドを呼び出してを初期化する必要があります。 この非同期の初期化中 NMAARController にもが作成されます。 についての詳細は NMAARController、『 LiveSight のカスタマイズ』を参照してください。

LiveSight を開始および停止しています

LiveSight を制御するには、NMAARControllerstartstopWithAnimation:との 2 つの方法を使用します。 start 複合ビューを作成した後でメソッドを呼び出して 、 LiveSight モードをトリガーできます。 startすでに LiveSight モードで呼び出し NMAARErrorInvalidOperation を行っている場合、エラーコードが返されます。 stopWithAnimation: メソッドを使用して LiveSight を停止します。

図 1. LiveSight