RealityKit Traceについて

RealityKit Traceについて

RealityKit Traceを使用して空間コンピューティングアプリのパフォーマンスを向上させる方法を確認しましょう。このプラットフォームのパフォーマンスプロファイリングに関するガイダンスと、RealityKit Traceテンプレートを使ってアプリのレンダリングを最適化する方法を学びます。また、アプリ内のさまざまなタイプのコンテンツをプロファイリングして、パフォーマンスの問題を特定するためのガイダンスも紹介します。

関連する章
- 0:44 - Rendering
- 2:17 - Profiling spatial apps
- 3:34 - Introduction to RealityKit Trace
- 7:38 - Optimizing offscreen passes
- 11:30 - Optimizing asset rendering
- 14:02 - Optimizing system power impact
- 17:55 - Overview of optimized World app
- 19:01 - Recommendations
リソース
- Analyzing the performance of your visionOS app
- - HDビデオ
  - SDビデオ
関連ビデオ

WWDC23
WWDC21
- Metalのデバッグ、プロファイリング、アセット作成ツール
Tech Talks
- レンダリングフェーズでの滞りを紐解き排除する
ダウンロード

♪ 心地よいヒップホップ音楽 ♪ ♪ こんにちは Sarinaです RealityKit Toolsチームのソフトウェアエンジニアです Harjasですプロファイリングツールエンジニアです今日はInstrumentsの RealityKit Trace テンプレートが空間エクスペリエンスのパフォーマンスを最適化するのにどう役立つかを説明します空間コンピューティングにおけるユーザーエクスペリエンスにはパフォーマンスが不可欠です空間エクスペリエンスを最適化する方法を学ぶためにこのプラットフォームのレンダリングの仕組みについて簡単に説明し Instrumentsで RealityKit Traceテンプレートを使いプロファイリングする方法を示しますコンテンツを最適化するために利用できる他の優れたツールについても簡単に説明しますこのプラットフォームには固有のパフォーマンス制約がありますこれらを理解するにはまずレンダリングの仕組みを理解する必要がありますレンダリングにはアプリのプロセスレンダリングサーバーコンポジターがありますアプリがこれらのコンポーネントとどのように相互作用するかは作成するエクスペリエンスの種類によって異なります空間アプリ用に作成できるエクスペリエンスの種類とそれらがどのようにレンダリングされるかを見てみましょうプラットフォーム上のアプリは共有スペースまたはフルスペースに入ることができますこれらはレンダーのされ方によって考慮すべきパフォーマンスにさまざまな影響を及ぼします複数のアプリを並行して実行するとそれらはすべて同じ空間にレンダリングされますこれが私たちがそれを共有スペースと呼ぶ理由の1つですこれはアプリのパフォーマンスが他のアプリをレンダリングするようサーバーが実行している作業の影響を受ける可能性があることを意味します次にレンダーサーバーがコンポジターと連携して最終フレームを生成しますアプリがFull Spaceに入ると他の表示されているアプリはすべて非表示になりますこれはアプリのパフォーマンスが現在非表示になっているアプリのレンダリング作業の影響を受けなくなることを意味していますフルスペースに入る方法の詳細についてはセッション「Go beyond the window with SwiftUI」をチェックしてくださいこれまで説明した内容に基づいてアプリのプロファイリングに推奨される方法が2つありますパフォーマンスの問題を調査したりシステム電力への影響を分析したりするときは常にアプリを個別にプロファイリングしてアプリがシステムパフォーマンスに与える影響を理解しますアプリが他のアプリと連携して動作することが期待される場合はアプリを他のアプリとともにプロファイリングする必要がありますこれはユーザーがアプリをどのように体験するかを理解するために重要です空間アプリをプロファイリングして RealityKit Traceテンプレートを使用しアプリのパフォーマンスを個別に最適化する方法を示しましょう私たちはHello Worldの開発に取り組んでおりパフォーマンスに問題がないことを確認したいと考えていますこれはアプリのスタート画面で SwiftUI Viewですこのビューには「Orbit内のオブジェクト」ボタンがありますそのボタンをタップすると地球を周回する物体について詳しく知ることができますボタンをクリックすると地球の周りを周回しているさまざまな天体の例をリストする新しいビューが開きますこのビューには次のようなオブジェクトの 3Dモデルが含まれています月や望遠鏡ですこのビューにはView Orbits (軌道を表示する)ボタンもありますボタンをタップするとイマーシブなエクスペリエンスが開きます地球とその周りを周回する衛星これらのモデルには詳細なアセットが使用されておりこのアプリのパフォーマンスに影響を与えていると思われますイマーシブな体験では地球を周回する衛星の軌跡がアニメーションで表示されます地球を拡大してさらに詳しく見ることもできますこのインタラクションはものすごく途切れ途切れなのでここにパフォーマンスの問題があると思います Harjasと私は RealityKit Traceテンプレートを使いそのエクスペリエンスをプロファイリングしました Harjas 説明してもらえますか？もちろんです RealityKit Traceで利用できるすべての機能を見てみましょう RealityKit Traceは Instruments 15の新しいテンプレートとして利用できます実際のデバイスとシミュレータの両方のプロファイリングに使用できます最も正確で実用的な情報を取得するには実際のデバイスのプロファイリングを行う必要がありますシミュレータに対してプロファイリングを行う場合 Macとオンデバイス間のハードウェアとソフトウェアの違いのためすべてのタイミング情報が正確であるとは限りませんただし素早い反復や時間に基づいていない一部の統計の改善には引き続き使用できます RealityKit Traceテンプレートにはいくつかの計測器が含まれています最初に見ていきたいのは RealityKit Frames Instrumentですこのデバイスはデバイスによってレンダリングされている各フレームを追跡しますこれらのフレームを拡大して各フレームのレンダリングにかかった時間を確認できますこれによりフレームの各ステージのレンダリングにかかった時間を確認できますこれによりレンダーパイプラインのどの部分が原因でパフォーマンスの問題が発生する可能性があるかの概要がわかりますスムーズなユーザーエクスペリエンスを実現するにはアプリが1秒あたり 90フレームを達成する必要がありますただしOSが常に90fpsを目標にしているわけではありません表示されているコンテンツとデバイスの環境に最も適したフレームレートでレンダリングしますフレームレートは変更する可能性があるためすべてのフレームにはレンダリングの完了期限がありデバイスが現在のターゲットフレームレートに到達できるようにしますフレームは3つのグループに分類されます期限内にうまく完了しているフレーム期限内にぎりぎりで完了しているフレームフレームが期限を過ぎて実行されフレームドロップが発生しているフレームこれらの分類はそれぞれ緑オレンジ赤に色分けされています期限を過ぎて実行されるフレームはユーザーエクスペリエンスに悪影響を及ぼしますズームアウトして上からフレームを確認すると色分けされているためトレースの問題のある部分をすぐに見つけることができますしたがってパフォーマンス調査を最もフレームドロップが発生している領域に絞り込むことができます個々のフレームに加えてこのデバイスはシステムがCPUまたは GPUの作業に費やした平均時間も視覚化し各フレームをレンダリングします次にチェックしたいのは RealityKit Metricsですトップレベルではデバイスは検出したすべてのボトルネックを抽出しますこれらのボトルネックはレンダーパイプライン全体からの包括的なタイミング情報を調べることで生成されますフレームが期限を超えると同時に発生するボトルネックを優先します以下の詳細ビューでは RealityKitのボトルネックが重大度および種類ごとにまとめられているのがわかりますさらに掘り下げてデバイスが発見したボトルネックの種類と全体的なパフォーマンスへの影響を正確に確認できます拡張詳細ビューではデバイスはこれらのボトルネックをさらに診断する方法とそれらを軽減するために実行できる手順についての推奨事項を提供します RealityKit Metrics トラックを展開するとレンダーパイプラインのさまざまなコンポーネントから数種類のメトリックスが表示されますこれらの統計はアプリが提示するシーンの完全な複雑さを理解するのに役立ちます主要なメトリックスの一部にはそれらのメトリックスに対する合理的な期待を知るのに役立つしきい値が関連付けられていますメトリックスを使用するとボトルネックやフレームが期限に間に合わない理由などの診断に役立ちます RealityKit Metricsは各フレームにどれだけの時間が費やされているかを視覚化しアプリのRealityKit システムを実行しますこれにはすべての組み込みシステムとアプリが実装するすべてのカスタムシステムが含まれますこの情報はTime Profilerと組み合わせるのが最適で RealityKitシステムコードを最適化できます最後にRealityKitメトリックスに表示されているシステム電力影響レーンを確認して素晴らしく一貫したユーザーエクスペリエンスを提供するためにアプリが動作する必要があるパワーエンベロープを理解しますここで私たちが世界の体験中間に取ったいくつかのトレースを見てみましょうアプリの最初のシーンはSwiftUIで実装されたスタート画面でしたフレーム計測ではこのトレース全体でかなりの数のフレームがドロップされていますこれらのフレーム落ちは重要ではないように見えますがユーザーエクスペリエンスに大きな損害を与える可能性があります Optionキーを押しながらドラッグするとより問題のある分野の1つにズームインできます時間範囲を調整することで長時間実行フレーム中に RealityKit Metrics Instrumentが検出したボトルネックを確認できます Instrumentsは今回の最大のボトルネックがコアアニメーションエンコーディングであることを発見しましたそこでコアアニメーションの統計を確認してみますこの統計はの横にある開閉用三角ボタンをクリックしラベルの付いたトラックを選択すると表示されますこれらのコアアニメーションメトリックスはフレームドロップの原因を知るのに役立ちますメトリックスを調査するとその一部がメトリックスがどれほど深刻であるかのコンテキストを把握していることに気づくでしょうタイムラインではこれが色分けに反映されますこれは主要なメトリックスの適切なしきい値を示すためのものですタイムラインの視覚化に基づいてアプリがオフスクリーン準備数の推奨しきい値を超えているのは明らかです下部の概要はここで準備されるオフスクリーンの平均数が 180であることを示していますこれはかなり高い平均値ですコアアニメーションの統計を検討する場合留意すべき作業の種類が3つありますまず透明度とぼかし効果はシステムにとって非常に高コストな操作ですこれらのエフェクトはユーザーに最も大きな影響を与える場合に限定しそれ以外では控えめに使用しますレンダーパスの数はレイヤーの数によって決まりますコアアニメーションは画像全体を個別にレンダリングする必要がありますそして最後にオフスクリーンパスがあります名前が示すようにオフスクリーンパスはオフスクリーンでレンダリングされるレンダーパスでディスプレイ用ではありませんオフスクリーンパスではレンダリングパスが現在実行していることを一時停止する必要がありユーザーには表示されない作業を実行しますただし通常のレンダリングパスを続行するにはオフスクリーンパスの出力が必要ですオフスクリーンパスは特に空間アプリに影響を与えます他のアプリプラットフォームとは異なりこのプラットフォームは空間アプリを継続的にレンダリングしますあらゆるフレームはユーザーの頭の動きなどの環境要因を考慮する必要がありますしたがって静的UIはシステムのターゲットフレームレートでレンダリングできるほど効率的である必要がありますオフスクリーンパスを引き起こす可能性のある作業には主に4つのタイプがありますシャドウマスキング角丸長方形と視覚効果ですオフスクリーンパスについて詳しくは Tech Talksの「Demystify and eliminate hitches in the render phase」をご覧くださいオフスクリーンパスが多かったのでこのビューのSwiftUIコードをチェックしてその原因を特定します SwiftUIコードではこのビューはマスキングや視覚効果を実行しませんただしシャドウが適用される例もありますたとえばSwiftUI View アイテムではいくつかのボタンにシャドウが適用されていますシャドウは特に透明性と組み合わせた場合特にコストが高い操作ですシャドウは便利なUIイディオムですが空間アプリの場合はユーザーに重大な効果をもたらしたときシャドウを使用する必要がありますこれらのシャドウを無効にして新しいトレースを見てみましょうシャドウを無効にした状態で RealityKit Frames Instrumentでフレームの問題はほとんどなく RealityKit Metricsではオフスクリーンパスが4分の1に減少したと報告しています Worldアプリで見た次のシーンは軌道ビュー内のオブジェクトですそのシーンからトレースを開いて最適化できるものがないかどうか確認するつもりです Frames Instrumentではドロップされたフレームが散在しトレース全体にボトルネックがたくさんあります RealityKitメトリックスの詳細ビューにはこれらのボトルネックの概要が表示されます
要約するとこれらのボトルネックのほとんどは GPUワークストールに関連しています最も頻繁に報告されるボトルネックのタイプは GPUストールであるため再びRealityKit Metrics を拡張していきますただし今回は3Dレンダートラックを使用して調査します
フレームドロップの数が多いトレース領域を選択しますこの時間選択では 3Dレンダリングメトリックスは三角形と頂点数が推奨しきい値をはるかに超えています次にフレームドロップがほとんどないトレース領域を強調表示します
レンダリングメトリックスによると三角形と頂点の数は推奨しきい値内にありますこれはアプリがシーン内で使用するアセットの数と品質を実際に評価する必要があることを意味しますアセットのレンダリングを最適化するときは RealityKitメトリックスでまず三角形と頂点を確認し 3Dレンダリンググループからの描画呼び出しを確認しますこれらのメトリックスを最適化するには可能な限り単純な形状のメッシュを使用します同じメッシュのアセットを利用する場合はインスタンス化を活用してください新しいメトリックスツールである Reality Composer Proの統計を使用してアセットの複雑さをチェックしますこれにより3Dコンテンツを組み立て編集しプレビューできますそのコンテンツは後で Xcodeプロジェクトのコードを通じて直接アクセスできますこのツールの詳細と優れたアセットの作成方法については「Meet Reality Composer Pro」セッションをチェックしてください先に進んで使用していたアセットを使用するポリゴンが少ないアセットと交換し新たなトレースを捉えましたこのトレースでは Frames Instrumentはすべてのフレームが期限に達していることを報告しますそして3Dレンダリング統計をもう一度確認すると
三角形と頂点の数が大幅に減少していることが報告されていますこれらのアセットでは使用するポリゴンの数が減りましたがエクスペリエンスの品質は低下しませんでした次のトレースは地球モデルとインタラクションしていたときのものですこのシーンでは地球のサイズを変更するのが実際にはかなり不安定でした RealityKit Metricsはシステム電力影響レーンがかなりの時間にわたって非常に高かったと報告していますこれはアプリの一部が非常に非効率でありユーザーエクスペリエンスが影響を受ける可能性があります可能な限り通常の状態でデバイスのシステム電力への影響を維持しアプリが適切に動作することを目標にする必要がありますシステム電力への影響を軽減するためにプロファイリングを行う場合は常にアプリを分離してプロファイリングを行い最も実用的な情報を確実に入手できるようにしますいくつかの方法を使用してシステム電力への影響を軽減できますまずRealityKit Metricsの統計が想定内であることを確認しますこれらが予想を超えている場合デバイスは長時間にわたってスムーズな体験を提供するためにより高い電力状態で動作します次にCPUとGPUがどのような作業を行っているかを確認します CPUについては高電力描画領域中に Time Profilerが高いCPU使用率を報告するかどうかを確認しますその場合はTime Profilerを使用しながら CPUバウンドのコードを最適化します GPUにはパフォーマンス状態があります GPUが最大段階にあるときかなりの量の電力が消費されますその場合 InstrumentsのMetal System Traceテンプレートを使用して GPUでどのような作業が行われているかを確認する必要がありますそうすることで何を最適化できるか理解できますトレースを遡ってみると Time Profilerはこの領域のCPU使用率が平均100%であることを示しておりこの時間のほとんどにおいて GPUパフォーマンス状態は最小でした Time Profiler を使用するとCPU 使用率が高くなる原因を確認できます最も重いスタックトレースは拡張詳細ビューにありますこれはコールツリー内のコードの最も高コストなパーツを素早く見つけることができるため Time Profilerの非常に便利な機能ですこれらのフレームを見ると Entity.makeModelが大量のCPU時間を使用していることがわかります次のフレームではEntity.generate CollisionShapesを呼び出しますしたがってパフォーマンスの問題はモデルと衝突形状を絶えず生成することが原因であると考えられますこれは高コストな操作です Xcodeを開きこれについて何ができるか確認しますこれはコールツリーで多くのCPU時間を消費していることを示した Entity.makeModel 関数呼び出しですこれはmakeGlobe関数内で呼び出されます Controlキーを押しながら makeGlobe関数をクリックしそれを呼び出している元を確認します Orbit SwiftUIビュー本体から呼び出されますビュー本体を非常に迅速に計算する必要があるためこれは避けるべきアンチパターンです SwiftUIビュー本体でモデルの読み込みやその他のコストのかかる操作は避けてくださいビューの状態が変わるたびにこれらの高コストな操作はすべて再計算する必要があるからです私がやろうとしていることはビュー本体からこの呼び出しを削除することです次にViewModelに Earthエンティティの再利用可能なバージョンを追加します最後に再利用可能な Earthエンティティを Orbit Viewで使用しますこれでビュー本体が再計算されるときにアプリは同じモデルの再読み込みに時間を無駄にすることがなくなりました修正後のトレースを見ると電力への影響が公称状態に戻っていますまたTime Profilerは CPU使用率が100%から 10%に低下したことを報告しますこれらすべての最適化を行った後ボトルネックはほとんど報告されていませんほぼすべてのフレームが期限に達しておりパワーは予想の範囲内です Worldアプリはこのプラットフォーム用によく最適化されたアプリになりましたオフスクリーンパスの数が減ったのでハイポリゴンのアセットを合理的なアセットに置き換え CPUと電力の使用量を削減するためこのアプリの最適化されたバージョンを段階的に実行していきますスタート画面は素晴らしくシャドウはユーザーエクスペリエンスにあまり影響を与えていなかったのでこれは良い最適化でした次にOrbit内のオブジェクトを開いてみましょうポリゴンの少ないアセットを使用しているにもかかわらずこれらのモデルは見栄えがしますその余分な詳細はリソースを無駄にしているだけでした最後に地球モデルを再度開いてサイズ変更を試みます
このインタラクションはバターのようにスムーズになりました以上がRealityKit Traceを使用してアプリをこの新しいプラットフォームに最適化する方法の簡単な概要でしたところでSarina メトリックスが利用できるツールは他に何がありますか? 空間コンピューティング向けにアプリを最適化するのに役立つツールがいくつかあります SwiftUIコンテンツを最適化するには SwiftUIとコアアニメーションとハングを分析するための Instrumentsアプリ内にドメイン固有のツールがありますハングについては「Analyze hangs with Instruments」セッションで詳しく学ぶことができます 3Dアセットベースのコンテンツを最適化する利用可能なツールもいくつかあります Time Profiler Instrumentはアセットのロードに長い時間がかかるなどアプリが最も時間がかかっている領域を見つけるのに役立ちます The RealityKit Metrics Instrumentはシーンにアセットが多すぎる場合や複雑すぎるアセットの診断に役立ちます最後にReality Composer Proを使ってシーンを組み立てているときにアセットの複雑さをチェックできます Reality Composer Proについて詳しくは「Meet Reality Composer Pro」セッションをご覧くださいアプリでMetalを使用している場合最も便利なツールはInstrumentsの Metal System TraceテンプレートですこのテンプレートにはGPUタイムライン GPUカウンターと GPUパフォーマンスステートなどの主要なメトリックスが含まれていますこのテンプレートとMetalコンテンツのプロファイリングのためのその他のツールの詳細については「Discover Metal debugging, profiling, and asset creation tools」セッションをご覧くださいまとめるとこのプラットフォームにはパフォーマンスが不可欠です可能な限り最高のユーザーエクスペリエンスのためにアプリを適切に最適化する必要があります RealityKit Trace テンプレートを使用してアプリ内のパフォーマンスのボトルネックを見つけることができます他のツールを使用してプロアクティブにプロファイリングし Reality Composer Pro でコンテンツをチェックするとパフォーマンスの問題を見つけて解決するのにも役立ちます RealityKit Trace テンプレートを使用してアプリを最適化する方法の詳細についてはメトリックスドキュメントをご確認くださいパフォーマンスをより深く理解するためにこのプラットフォームについてのセッション「Optimize app power and performance for spatial computing」をご覧くださいトレースがどのようなものであっても空間コンピューティングアプリの最適化をお楽しみくださいご視聴ありがとうございます ♪

10:50 - SwiftUI View with High Offscreens

private struct Item: View {
    var module: Module

    // The corner radius of the item's hightlight when selected or hovering.
    let cornerRadius = 20.0

    var body: some View {
        NavigationLink(value: module) {
            VStack(alignment: .leading, spacing: 3) {
                Text(module.eyebrow)
                    .font(.titleHeading)
                    .foregroundStyle(.secondary)
                VStack(alignment: .leading, spacing: 7) {
                    Text(module.heading)
                        .font(.largeTitle)
                    Text(module.abstract)
                }
            }
            .padding(.horizontal, 5)
            .padding(.vertical, 20)
        }
        .buttonStyle(.bordered)
        .shadow(radius: 10)
        .buttonBorderShape(.roundedRectangle(radius: cornerRadius))
        .frame(minWidth: 150, maxWidth: 280)
    }
}

16:33 - EarthEntity Factory

class EarthEntity: Entity {
    static func makeGlobe() -> EarthEntity {
        EarthEntity(earthModel: Entity.makeModel(
            name: "Earth",
            filename: "Globe",
            radius: 0.35,
            color: .blue)
        )
    }

    static func makeCloudyEarth() -> EarthEntity {
        let earthModel = Entity()
        earthModel.name = "Earth"

        Task {
            if let scene = await loadFromRealityComposerPro(
                named: WorldAssets.rootNodeName,
                fromSceneNamed: WorldAssets.sceneName
            ) {
                earthModel.addChild(scene)
            } else {
                fatalError("Unable to load earth model")
            }
        }

        return EarthEntity(earthModel: earthModel)
    }
}

16:53 - Orbit SwiftUI View Body

struct Orbit: View {
    @EnvironmentObject private var model: ViewModel

    var body: some View {
        Earth(
            world: EarthEntity.makeGlobe(),
            earthConfiguration: model.orbitEarth,
            satelliteConfiguration: [model.orbitSatellite],
            moonConfiguration: model.orbitMoon,

            showSun: true,
            sunAngle: model.orbitSunAngle,

            animateUpdates: true
        )
        .place(
            initialPosition: Point3D([475, -1200.0, -1200.0]),
            useCustomGesture: model.useCustomGesture,
            handOffset: model.customGestureHandOffset,
            isCustomGestureAnimated: model.isCustomGestureAnimated,
            debugCustomGesture: model.debugCustomGesture,
            scale: $model.orbitEarth.scale)
    }
}

17:26 - SwiftUI ViewModel

class ViewModel: ObservableObject {
    // MARK: - Navigation
    @Published var navigationPath: [Module] = []
    @Published var titleText: String = ""
    @Published var isTitleFinished: Bool = false
    var finalTitle: String = "Hello World"

    // MARK: - Globe
    @Published var globeEarthEntity: EarthEntity = .makeGlobe()

    @Published var isShowingGlobe: Bool = false
    @Published var globeEarth: EarthEntity.Configuration = .globeEarthDefault
    @Published var globeEarthOffset: SIMD3<Double> = [0, 0, 0]
    @Published var globePanelOffset: SIMD3<Double> = [0, -50, 30]

    @Published var showSatelliteButton: Bool = false
    @Published var isShowingSatellite: Bool = false

    // MARK: - Orbit
    @Published var orbitEarthEntity: EarthEntity = .makeGlobe()

    @Published var useCustomGesture: Bool = true
    @Published var customGestureHandOffset: SIMD3<Float> = [0, 0.21, -0.07]
    @Published var isCustomGestureAnimated: Bool = false
    @Published var debugCustomGesture: Bool = false

    @Published var orbitSatelliteScale: Float = 0.9
    @Published var orbitMoonScale: Float = 0.9
    @Published var orbitTelescopeScale: Float = 0.8
    @Published var orbitSatelliteZOffset: Double = 100
    @Published var orbitMoonZOffset: Double = 100
    @Published var orbitTelescopeZOffset: Double = 100

    @Published var isShowingOrbit: Bool = false
    @Published var orbitImmersionStyle: ImmersionStyle = .mixed
    @Published var orbitEarth: EarthEntity.Configuration = .orbitEarthDefault
    @Published var orbitSatellite: SatelliteEntity.Configuration = .orbitSatelliteDefault
    @Published var orbitMoon: SatelliteEntity.Configuration = .orbitMoonDefault

    @Published var orbitSunAngle: Angle = .degrees(150)
    var orbitSunAngleBinding: Binding<Float> {
        Binding<Float>(
            get: { Float(self.orbitSunAngle.degrees) },
            set: { self.orbitSunAngle = .degrees(Double($0)) }
        )
    }

    // MARK: - Solar System
    @Published var solarEarthEntity: EarthEntity = .makeCloudyEarth()

    @Published var isShowingSolar: Bool = false
    @Published var solarImmersionStyle: ImmersionStyle = .full
    @Published var solarEarth: EarthEntity.Configuration = .solarEarthDefault
    @Published var solarSatellite: SatelliteEntity.Configuration = .solarTelescopeDefault
    @Published var solarMoon: SatelliteEntity.Configuration = .solarMoonDefault

    @Published var solarSunDistance: Double = 700
    @Published var solarSunAngle: Angle = .degrees(280)
    @Published var solarSunSpotIntensity: Float = 10.5
    @Published var solarSunEmissionIntensity: Float = 10.5
    var solarSunPosition: SIMD3<Float> {
        [Float(solarSunDistance * sin(solarSunAngle.radians)),
         0,
         Float(solarSunDistance * cos(solarSunAngle.radians))]
    }
}

17:33 - SwiftUI Orbit View Body

struct Orbit: View {
    @EnvironmentObject private var model: ViewModel

    var body: some View {
        Earth(
            world: model.globeEarthEntity,
            earthConfiguration: model.orbitEarth,
            satelliteConfiguration: [model.orbitSatellite],
            moonConfiguration: model.orbitMoon,

            showSun: true,
            sunAngle: model.orbitSunAngle,

            animateUpdates: true
        )
        .place(
            initialPosition: Point3D([475, -1200.0, -1200.0]),
            useCustomGesture: model.useCustomGesture,
            handOffset: model.customGestureHandOffset,
            isCustomGestureAnimated: model.isCustomGestureAnimated,
            debugCustomGesture: model.debugCustomGesture,
            scale: $model.orbitEarth.scale)
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

関連する章

リソース

関連ビデオ

WWDC23

WWDC21

Tech Talks