フレームワーク

ARKit

iOSデバイスのカメラ機能とモーション機能を統合し、アプリやゲームの中で拡張現実体験を生み出します。

最新の英語ドキュメント

ARKit


概要

拡張現実（AR）は、デバイスのカメラからのライブビューに2Dや3Dのアイテムを追加して、そのアイテムがあたかも現実の世界に存在するかのように見えるユーザー体験です。ARKitは、デバイスのモーショントラッキング、カメラによるシーンの取得、高度なシーンの処理、便利な表示機能を組み合わせたもので、AR体験を容易に構築できるようにします。iOSデバイスのフロントカメラまたはバックカメラでこれらのテクノロジーを使って、さまざまなAR体験を生み出すことができます。

トピック

最初のステップ

拡張するカメラフィードの選択
フロントカメラまたはバックカメラのいずれかを通じて、ユーザーのAR環境にビジュアルエフェクトを追加します。
デバイスのサポートとユーザーの許可の確認
アプリでARKitを使用できること、および実行時にユーザーのプライバシーが尊重されることを確認します。
セッションのライフサイクルとトラッキングクオリティの管理
セッションの現在の状態について、ユーザーに継続的に情報を提供します。また、中断から復帰します。
class ARSession（英語）
AR体験の制御に使用する主要オブジェクトです。
class ARConfiguration（英語）
ARセッションで有効になっている機能を定義するオブジェクトです。
class ARAnchor（英語）
物理的環境における対象物の位置と向きに関する情報です。

カメラ

3D空間における位置や向き、カメラのビデオデータや露出など、ユーザーのiOSデバイスに関する詳細情報を取得します。
シーンの深度を利用したフォグエフェクトの作成（英語）
仮想のフォグ（ぼかし）を物理的環境に適用します。
シーンの深度を利用した点群の視覚化（英語）
シーンの深度データを使って現実世界にポイントを配置し、物理的環境の形状を視覚化します。
class ARFrame（英語）
セッションの一部としてキャプチャされた、位置トラッキング情報付きのビデオ画像です。
class ARCamera（英語）
特定フレームの、カメラの位置とイメージング特性に関する情報です。

AR Quick Look

アプリまたはWebサイトにAR体験を追加する、最も簡単な方法です。
AR Quick Lookを使ったモデルのプレビュー
ユーザーが移動、拡大・縮小、および共有できるモデルまたはシーンを表示します。
AR Quick LookおよびRealityKitでのビジュアルエフェクトの追加
モデリングの設定でAR体験のアピアランスとパフォーマンスを調整します。
AR Quick LookでのApple Payボタンまたはカスタムアクションの追加
ユーザーがタップして、購入やカスタムアクションを実行できるバナーをAR体験内で提供します。
class ARQuickLookPreviewItem（英語）
AR Quick Look体験のカスタマイズに使用するオブジェクトです。
AR向けのUSDZスキーマ（英語）
新しいUSDのスキーマを使って、拡張現実機能を3Dコンテンツに追加します。

表示

レンダリング処理するビューを使って、フル機能のAR体験を構築します。
class ARView（英語）
RealityKitを使ってAR体験を表示するビューです。
class ARSCNView（英語）
SceneKitを使ってAR体験を表示できるようにするビューです。
class ARSKView（英語）
SpriteKitを使ってAR体験を表示できるようにするビューです。

ワールドトラッキング

ワールドトラッキング（英語）
表面、画像、オブジェクト、人物、ユーザーの顔をトラッキングしてバックカメラでAR体験を創出します。

ジオトラッキング

ARでの地理的位置のトラッキング（英語）
対象となる特定の地理的領域をトラッキングし、AR体験内でレンダリングします。
class ARGeoTrackingConfiguration（英語）
地理的位置のトラッキングのための構成。
class ARGeoAnchor（英語）
地理的位置をトラッキングするオブジェクト。

フェイストラッキング

フロントカメラフィードに現れる顔をトラッキングします。
顔のトラッキングと視覚化（英語）
フロントカメラのAR体験内で顔を検出し、仮想コンテンツを重ねて、顔の表情をリアルタイムでアニメーション化します。
ユーザーの顔のトラッキングとワールドトラッキングの統合（英語）
バックカメラを使ってAR体験を表示するアプリで、ユーザーの顔をトラッキングします。
class ARFaceTrackingConfiguration（英語）
デバイスのフロントカメラを使って顔だけをトラッキングする場合に使う構成。
class ARFaceAnchor（英語）
フロントカメラフィードでARKitが検出した、顔のポーズ、トポロジー、表情に関する情報。

人物

カメラフィードでARKitが認識した人物に対し、処理を行います。
仮想コンテンツに対するピープルオクルージョン（英語）
カメラフィード内でARKitが認識した人物で、アプリの仮想コンテンツが背後に位置するよう、カバーします。
3Dで体の動きをキャプチャする（英語）
物理的環境で人物をトラッキングし、その人物と同じ動きを仮想キャラクターに適用することによって、人物の動きを視覚化します。
モーションキャプチャ用のモデルのリギング（英語）
カスタム3Dモデルを構成して、ARKitの人体トラッキング機能がそれらのモデルを制御できるようにします。
モーションキャプチャ用のモデルの検証（英語）
キャラクターモデルがARKitのモーションキャプチャ要件に適合することを検証します。
class ARBodyTrackingConfiguration（英語）
3D空間での人物の動きをトラッキングするために使う構成。
class ARBodyAnchor（英語）
カメラフィードでARKitが認識した身体について、3D空間における動きをトラッキングするオブジェクトです。
class ARBody2D（英語）
カメラフィードでARKitが認識した人物のスクリーン座標での表現です。

画像トラッキング

物理的環境で画像を認識し、その位置と向きをトラッキングします。
画像のトラッキングと変換（英語）
ユーザーの環境で検出された長方形の形状から画像を作成し、そのアピアランスを拡張します。
AR体験での画像検出（英語）
ユーザーの環境内にある既知の2D画像に反応し、その位置を用いてARコンテンツを配置します。
class ARReferenceImage（英語）
物理的環境でARKitに検出させたい画像の説明。
class ARImageAnchor（英語）
ワールドトラッキングARセッションで検出された、画像の位置と向きに関する情報。
class ARImageTrackingConfiguration（英語）
デバイスのバックカメラフィードを用いて、既知の画像だけでトラッキングする場合に使う構成。

オブジェクトの検出

最初にアプリでオブジェクトをスキャンすることによって、実行時に既知のオブジェクトを認識します。
3Dオブジェクトのスキャンと検出（英語）
現実世界のオブジェクトの空間的特徴を記録します。その後、その記録に基づいてユーザー環境で該当オブジェクトを探し、ARコンテンツを起動します。
class ARReferenceObject（英語）
ARセッション中に物理的環境でARKitに検出させたい現実世界のオブジェクトの説明。
class ARObjectAnchor（英語）
ワールドトラッキングARセッションで検出された、現実世界の3Dオブジェクトの位置と向きに関する情報。
class ARObjectScanningConfiguration（英語）
物理的環境で実際のオブジェクトの高忠実度の空間データを収集するために使う構成。

向きのトラッキング

class AROrientationTrackingConfiguration（英語）
デバイスのバックカメラを使ってデバイスの向きだけをトラッキングする場合に使う構成。

位置のトラッキング

class ARPositionalTrackingConfiguration（英語）
空間におけるデバイスの位置だけをトラッキングする場合に使う構成。

レンダリングエフェクト

AR体験へのリアルな反射の追加（英語）
ARKitを使って、カメラの画像から環境プローブテクスチャを生成し、そのイメージが反映された仮想オブジェクトをレンダリングします。
class AREnvironmentProbeAnchor（英語）
ワールドトラッキングARセッションの特定空間の環境照明情報を提供するオブジェクト。
class ARLightEstimate（英語）
ARセッションでキャプチャされたビデオフレームに関連付けられた、推定のシーン照明情報。
class ARDirectionalLightEstimate（英語）
フェイストラッキングARセッションでキャプチャされたビデオフレームに関連付けられた、推定の環境照明情報。

マルチユーザー

ほかのデバイスと通信して共有AR体験を生み出します。
共同セッションの作成（英語）
ピアツーピアのマルチユーザー接続を使って、近くのデバイスがAR体験を共有できるようにします。
マルチユーザーAR体験の作成（英語）
ホスト／ゲストのマルチユーザー接続を使って、近くのデバイスがAR体験を共有できるようにします。
SwiftShot：拡張現実ゲームの作成（英語）
AppleがWWDC18で紹介したデモのコードです。どのように構築されているか確認し、ARKit、SceneKit、Swiftを使ってオリジナルのマルチプレイヤーゲームを作るヒントにしてください。
class ARSession.CollaborationData（英語）
物理的環境についてユーザーが収集した情報を保持するオブジェクトです。
class ARParticipantAnchor（英語）
マルチユーザーAR体験で別のユーザーを表現するアンカーです。

オーディオ

オーディオを使った臨場感のあるAR体験の作成（英語）
サウンドエフェクトや環境音レイヤを使用して、魅力的なAR体験を作成します。

テキスト

アンカー付きのテキストを表示して、AR体験に注釈を追加します。
AR体験におけるオブジェクトへの画面注釈の追加（英語）
実際のオブジェクトおよび仮想オブジェクトに重ねて画面上に仮想付箋紙を表示し、AR体験に注釈を加えます。
任意オブジェクトの認識とラベリング（英語）
カスタムの光学認識アルゴリズムを使って、カメラフィードで認識したオブジェクトのアンカーを作成し、そのオブジェクトをトラッキングします。

カスタム表示

独自のレンダラーを実装して、フル機能のAR体験を作成します。
カスタムレンダラーでのピープルオクルージョン効果（英語）
マットジェネレータを用いて、カメラフィードでARKitが人物を認識した領域においてアプリの仮想コンテンツを隠します。
Metalを利用したAR体験の表示（英語）
カメラフィードの上で、アプリの仮想コンテンツのレンダリングを制御します。
class ARMatteGenerator（英語）
カメラフィードでARKitが人物を認識した領域においてアプリの仮想コンテンツを隠すために使う、マットテクスチャを作成するオブジェクト。

クラス

class ARAppClipCodeAnchor（英語） Beta