空間的なSharePlay体験の構築

空間的なSharePlay体験の構築

GroupActivitiesフレームワークを使って、visionOSのための独自の共有コラボレーション体験を作成する方法を見ていきます。このプラットフォームにおけるSharePlayを紹介し、まるで同じ空間にいるような存在感を人々に与える体験をどのように作成するかを学びます。その上で、イマーシブなアプリが参加者間での共有コンテンツを体験する方法についてお話しします。

リソース
- SystemCoordinator
- - HDビデオ
  - SDビデオ
関連ビデオ

WWDC23
WWDC21
- Group Activitiesによるカスタムエクスペリエンスの構築
WWDC19
- 複数のウインドウでコンテンツのターゲットを設定する
ダウンロード

♪♪ ♪ Willem Mattelaer：こんにちは Willemです Group Activitiesを手掛けるエンジニアです Miaと一緒にお話しするのは素晴らしい空間的なSharePlayアプリの構築方法についてですほかの人が近くにいても遠くにいても一緒にいて何か行えるというのが SharePlay体験ですこのプラットフォームでは FaceTime中に同じ場所にいるという感覚が強くなりますこのプラットフォームでのFaceTimeでは空間Persona全員が一つのウィンドウに縛られるのではなく部屋の中の物理的空間を占めるのですほかの人達と一緒にいるという感覚が増してきますそれに加えて共有コンテキストを導入しています共有コンテキストとは全員にとってほかの全員が同じ相対位置にいるように見えるという事ですこの説明に 2つの異なる視点を考えていきます左側が表すのはConnorの視点で右側はMiaの視点です ConnorがMiaのPersonaを指し示せば MiaはConnorのPersonaが自分を指し示したと分かりますこれを共有体験にも拡張しその中にSharePlayも含まれますが SharePlay内では全員にとって相対的な同じ位置に窓が置かれるのですそれにはテンプレートを使っていますテンプレートは参加者や共有アプリがお互いに対してどう相対的に位置づけられるかを決めるために使われますそれによって空間的な一貫性が生まれますアプリは自ら置き換えを行う必要はなくそれをシステムに任せる事ができますアプリが懸念すべき唯一の事は視覚的一貫性を持つ事です視覚的一貫性というのは全員がアプリの中で同じコンテンツを見ているという事です例えばホワイトボードの前にほかの人達と立っているとします全員が同じホワイトボードのビューを持っています誰かが何かを指し示せばほかの人は全員その人が何を指しているか分かります私たちがSharePlayの空間体験で再現したいのはこれです先ほどの例に戻りますがここではアプリに視覚的一貫性がありませんアプリでConnorが四角を指し示すと MiaにはConnorのPersonaが丸を指していると見えていますこれでは一緒にいるという感覚が損なわれますですがアプリに視覚的一貫性があれば MiaはConnorの指しているのが四角だとはっきり分かりますコンテンツとその配置を全参加者に対して同期するのはアプリの責任ですそうすれば全員が本当に一緒にいるかのように完全に同じアプリを見ている感覚になります「Design spatial SharePlay experiences」のセッションでこれらの概念についての詳細が出ています是非そのセッションを見て詳しい内容を学んでくださいこのプラットフォームで FaceTimeに導入された新しいコンセプトをいくつか見たところで SharePlayを採用する時にウィンドウアプリが考えるべき事と既存のiOS SharePlayアプリが空間設定で使われた時に体験向上のために取るべき追加のステップについて見ていきましょうのちほどMiaが驚くような没入感の SharePlay体験を作成するための新しいAPIをお見せしますウィンドウアプリでSharePlayをサポートするためにグループセッション用の新しいシステムコーディネータを追加しましたシステムコーディネータは 2つの事を担当しますアクティブなSharePlayセッションのシステム状態を受け取る事と SharePlay中みなさんに追加の設定提供をさせる事です私がカバーする2つはウィンドウアプリにも没入型アプリにも関連している事で isSpatialフラグとテンプレートの設定についてです要求される視覚的一貫性の水準を決める時には参加者が空間的であるかどうかを知る事が重要です例えばこちらはConnor本人の視点です赤のMiaと通話中で私がSharePlayで共有したドキュメントを見ていますこのシナリオでのMiaの視点は右側で青のConnorが見えています Connorがスクロールすればスクロール位置を同期したいわけですそうすれば MiaはConnorがスクロールするのが見えて視覚的一貫性も保たれます実際これはSharePlay中にフリーボードで平行移動している時に行なっていますですが空間的でない参加者はドキュメントを操作している相手のコンテキストがありませんなので Connorがスクロールしてもそれを同期すべきではなく Miaはドキュメントの同じ場所を見続ける事になりますローカルの参加者が空間的かどうかを調べ参加者間で何を同期するか調整するためにはまずはグループセッション用のシステムコーディネータが必要ですローカルの参加者が空間的であるか知るにはローカルの参加者状態で isSpatialがtrueであるかチェックします状態を調べるために使えるlocalParticipantStateプロパティはローカルの参加者状態の更新を通してイテレートする非同期のシーケンスを戻しますシステムコーディネータはアプリにテンプレートの設定を提供する方法も提示しますテンプレートは空間的一貫性を確立するためにアプリに関連するシステムが参加者全員をどう配置するのか決めるために使います私たちがサポートするのは 3つの異なるテンプレートです Side-by-Sideでは参加者全員がアーチ状に並んで共有アプリの方を向いていますこれはデフォルトのテンプレートでアプリが通常のウィンドウシーンを使っている場合に適用されます Conversationalテンプレートでは参加者全員が半円に並んでアプリはその半円の前に置かれますこれはアプリのコンテンツにフォーカスが無い場合にピッタリです例えば SharePlayで音楽の演奏をしている場合ですね最後は Surroundテンプレートですこの場合参加者は円になっていてアプリはその円の中心に置かれますこのテンプレートが使えるのはアプリがボリュメトリックシーンを使っている時だけです参加者とアプリの距離はアプリのサイズに基づいて決まりますアプリが大きければ人々から遠く離れて配置されますアプリが小さければ近い位置に置かれます SharePlayアプリはシステムコーディネータを通してテンプレート設定を提供します FaceTimeはグループセッションがアクティブな間にこのテンプレートを適用しようとします SharePlayアプリには 3つの設定が利用できます .noneはシステムのデフォルトビヘイビアに従い縦型アプリでは Side-by-Sideにボリュメトリックアプリでは Surroundになりますこれが使用されるデフォルト設定ですまた .sideBySideだとアプリの種類に関係なく Side-by-Sideテンプレートを採用しようとします最後は .conversationalで名前に対応するテンプレートを採用しようとしますテンプレート設定を構成するにはシステムコーディネータの設定でグループセッションの参加が始まる前に設定すればいいのですテンプレートはアプリや参加者を最適の位置に置くために使われますですがアプリに複数のウィンドウシーンがあって一度に複数が前景化されている場合はどうなるでしょう？この例ではアプリに 3つのシーンがあります左のシーンはブラウズ用のビューです真ん中の小さいシーンはコンテンツを簡単にナビゲートするためのものです最後のシーンは1つのコンテンツについての詳細情報を提供するものですこのすべてのシーンは同時に開けられるので読みながらコンテンツを簡単にナビゲートできます SharePlayでは詳細情報のシーンを共有シーンにしたいわけですですが全部が開いていると誤ったシーンがテンプレートに使われるかもしれませんそれを解決するためにシーンの関連付けを追加しましたこれでシステムはアプリのどのシーンが SharePlayアクティビティをホストしているのか分かりますどのシーンであるか知るのには 2つの理由がありますまずウィンドウの上にあるShareメニューにどのシーンが共有されているのか表示されるようになるからです複数のウィンドウが開いている時には便利なインジケータがあればうっかり誰かが共有ウィンドウとインタラクトするような恥ずかしい状況を回避しやすくなりますですがもっと重要なのはテンプレートでどのウィンドウシーンが使われるのか決定される事ですアプリが単一シーンのものであれば心配する必要はありません使えるシーンは1つしかないので自動的にそのシーンがグループセッションに関連付けされますですが複数シーンを持つアプリは SharePlayを採用する時に関連付けを考慮すべきです関連付けが採用されていないと開いているシーンから無作為に選ばれ不適切なシーンが選ばれるかもしれませんではシーンの関連付けの採用方法を見ていきましょうまずは SharePlayアクティビティを開始した人にとってどうなるでしょうかグループアクティビティの起動時に各シーンをチェックしてどのシーンが関連付けを処理できるか確認しますグループアクティビティのアクティビティ識別子に対してシーンのアクティブ化条件を評価するという方法を取りますシーンのアクティブ化条件には 2つのチェック項目がありそれは canとprefersです canはそのシーンが関連付け処理の可能性がある事を意味し prefersはもっと関連付けにふさわしいシーンへと促しますそれでは左側のシーンをチェックしてアクティビティ識別子を処理できるかほかに促すか見て見ましょう CanですがPrefersではありません次は真ん中のシーンで両方ダメですそして最後のシーンを見ると CanもPrefersも大丈夫です最後のシーンがCanもPrefersも大丈夫だったのでグループセッションにはこれを関連づける事にします識別子を処理できるシーンが無ければ新しいウィンドウシーンを起動します SharePlay体験に独自の作業シーンが必要な場合はピッタリです複数のシーンがCanであり Preferがなければそのうちの1つのシーンが無作為に選ばれますグループアクティビティを有効化せず受けているだけの参加者にとってはアプリが既に実行されているなら同じ論理が適用されますまだアプリが実行されていなければ起動後の最初のシーンが関連付けられます SwiftUIアプリLifecycleを使っているアプリのシーンアクティブ化条件を特定するには handlesExternalEventsが使えますグループアクティビティのアクティビティ識別子を preferringかallowingの文字列のセットに入れるだけですアプリが UIKitアプリlife cycleを使っている場合はプレディケートを特定する事で UIシーンでアクティブ化条件が設定できますシーンのアクティブ化条件について詳細を学びたい場合は 2019年のセッションを見てくださいもう1つの例を見ていきましょうここではドキュメントベースのアプリで各シーンは異なるドキュメントを表示しています今からSharePlayを使って最初のドキュメントでのコラボレーションをしようと思いますここでもグループアクティビティ識別子で各シーンのアクティブ化条件を評価していきます残念ながらこれらのシーンには本質的な違いが無く全部マッチしているため誤ったシーンが関連付けられてしまいますこの場合はシーンをマッチさせるために使われる識別子を変えましょうそのためにシーンを関連付けるビヘイビアを追加しましたこれでアプリは正しいシーンを探すのに使われる識別子が提供できるようになります例に戻ると参加者全員が納得するような各ドキュメントに特有の識別子を使う事ができますその識別子を使って正しいシーンを見つけます今シーンを評価するとシーンのアクティブ化条件は簡単に設定できるので最初のシーンだけがマッチし正しいシーンの関連付けができましたシーンの関連付けビヘイビアの設定で使われる識別子の特定はグループアクティビティのメタデータで行えます SharePlayセッションに参加する参加者全員に同じ識別子が使われる事を忘れずにですから全員が納得するようなものを使いましょうシーンの関連付けビヘイビアでは 3つのタイプをサポートしています Defaultが最初に見たビヘイビアでシーンの関連付けに使われた識別子がグループアクティビティ識別子になります名前の通りこれがデフォルトのビヘイビアで明確に特定しなければこれが使われます Contentビヘイビアはカスタムの識別子を特定させてくれます各シーンが異なるコンテンツを示しグループアクティビティがそのコンテンツに結びついているアプリのためのビヘイビアです最後は Noneビヘイビアです Noneビヘイビアはシーンの関連付けを無効にしますつまり関連付けされるシーンが無くなるのでアプリのどのシーンの上にも共有バナーが出ないという事ですまたこれは空間的一貫性が壊れている事も意味しますこれは特別なケースでのみ使われるべきで例えば追加のシーンが不要な没入型アプリの場合や SharePlayセッションで表示されるコンテンツが各参加者のそれぞれのシーンで異なるような場合です時にはグループセッションにどのシーンが関連付けられているのか知る必要があります複数のシーンがシーン関連付けに選ばれている可能性がある場合ですこの情報を得るためにグループセッションで公開した新しいプロパティが sceneSessionIdentifierですこのプロパティにはグループセッションに関連づけられたシーンセッションの識別子が含まれています素晴らしいSharePlay体験の構築にはシーンの関連付けは欠かせませんので複数シーンをサポートするアプリにはぜひ適用してくださいではようやく Shareメニューからの SharePlayについてです FaceTimeでは各ウィンドウの上に共有バナーがあります先ほど見たように SharePlay中にどのシーンが共有されているか示しますですが SharePlay中でない時も役立ちますシーンが共有されていない時シーンを共有できるいろいろな方法を示してくれます 1つは単純にウィンドウの共有ですほかの人は全員そのウィンドウの非インタラクティブなビデオフィードが見えますどのアプリでも最初から使えますですが SharePlayアプリならさらに可能性が広がりますウィンドウの現時点でのコンテンツに関連のあるグループアクティビティを公開する事でそのメニューの表面に出てきます SharePlayアクティビティの発見可能性を向上できる上に AppのUIに専用のSharePlayボタンを付ける必要もなくなりますグループアクティビティの公開は AirDropでSharePlayを始めるのと同じ方法で行います iOS 17では SharePlayアプリを開いておく事で AirDropでSharePlayが始められるようになりますグループアクティビティをフェッチするのにシステムは表示されているシーンの UIレスポンダチェーン内を探しそのうちの一つのレスポンダのアクティビティアイテム設定で特定されているグループアクティビティを見つけようとしますそうすると SharePlayコンテンツを表示しているビューコントローラのアクティビティアイテム設定でグループアクティビティを設定できてそれが自動的にピックアップされますアクティビティアイテム設定を行うにはまず有効化できるアクティビティを作ることから始めます次にアイテムプロバイダを作成してそこにグループアクティビティを登録しますそれからアイテムプロバイダで UIActivityItemsConfigurationを初期化します最後は設定が公開しているのが正しいメタデータである事を確認しましょうそれがShareメニューで表示されるからですそのためには metadataProviderを UIActivityItemsConfigurationで使い LinkPresentationMetadataキーのために LPLinkMetadataオブジェクトを提供します Shareメニューにはtitleと imageProviderが使われます UIActivityItemsConfigurationReadingに準拠する自分のクラスを使ってもすべてこの通りに作業できますこのプラットフォームでウィンドウの SharePlay体験を構築するために考慮しなければならない事項を話してきました Mia 没入型アプリの共有体験の構築方法を説明してくれますか？ Mia Ren：もちろんです Willem では没入型アプリでSharePlayがどうなるか見てみましょうこのプラットフォームでは Immersive Spaceを使って簡単に没入型体験が作成できます Immersive Spaceはアプリのコンテンツが異なる没入型スタイルで境界線を越えていく特別なシーンですアプリがImmersive Spaceを開くとシステムはほかのアプリをすべて背景化するのでユーザーは限りのない世界でこのアプリだけに集中できるのです下に出ているセッションから Immersive Spaceや Immersion Stylesの詳細が分かります FaceTime中いつでも Immersive Spaceが起動できますプライベートな没入型空間にいる時は自分だけの世界にいるのでありほかの人たちとの共有コンテキストを解除できますそのためにシステムはほかの人々を隠してくれますほかの人々が目にするのは連絡先の写真で今はその人たちと一緒にいない事を示していますそれでも音声での通話は誰でもできますでもほら FaceTimeで独りぼっちなんて嫌じゃないですか没入型世界で魔法の瞬間を共有しましょう友達と共有したくてたまらない没入型体験の素晴らしい案がたくさんあるんです例えばグループアクティビティでこんな風に宇宙空間にみんなで集まって一緒に美しい地球を探索する案ですこれを実現するために共有アプリはみんなで共有できるようなグループの没入型空間を設定する必要がありますシステムコーディネータの設定で supportsGroupImmersive Spaceフラグが見つかりますそれを有効化するとアプリがシステムにこのアプリのImmersive Spaceは共有するためのもので没入型のグループアクティビティをサポートしたいと伝えますこのフラグを有効化したグループセッションに人々が参加するとその人たちの没入型空間もグループの没入型空間になりますシステムは空間の原点をテンプレートの定義した共有位置へと動かして空間的一貫性のために共有の座標系を設定しますグループの没入型空間にいる人々はお互いをPersonaとして見ますこれでグループの没入型空間に共有の座標系と人々が置かれたのでその中の同じ位置にオプジェクトを置いて空間的一貫性が作れます地球探索アクティビティの例では地球を原点の真上の中心に置いて原点に対して全員に相対的になるよう同じ補正を加えるようにしますそうすると全員が地球の同じ位置を見ることになります次は視覚的一貫性を維持する方法です例えば地球を回転させたければその方向が全員にとって同期されてるようにする必要があります GroupSessionと GroupSessionMessengerを使って状態を同期する方法についての詳細は下に出ているSharePlayセッションをどうぞまた各個人に相対的な UIエレメントをグループの没入型空間に加える事もできます例えば各参加者にこのような個人的なコントロールメニューを与える事もできます各参加者のすぐ前にありますこれを使って共有された地球を簡単に操作できますこのコントロールを適切な位置に置くために知っておくべき事はグループの没入型空間のどこにローカルユーザーがいるかです GeometryReader3Dで systemExperienceDisplacementのメソッドが利用できますこのメソッドはシステムがローカルユーザーからどのくらいの位置に空間の原点を配置したかを教えてくれます Pose3D構造体を戻してそこには変換値と回転が両方とも入っています空間の原点に対してローカルユーザーがどこにいるのか知るためにはこのポーズが反転できますそれを使ってコントロールを補正反転するとローカルユーザー対して相対的にコントローラが現れますですがユーザーが動くとコントローラの移動はアップデートされません最初に置かれた時だけ空間の移動が可能になりますこれによりその人がどこにいるか完全に追跡する必要なくコンテンツを簡単にその人に相対的に置く事ができます地球探索アクティビティのように共有コンテンツが真ん中にあるグループの没入型空間だけを持つようなアプリには Surroundテンプレートはピッタリですですが共有ウィンドウとグループの没入型空間を両方持つグループアクティビティならどうでしょう？例えば私はここに出ているような太陽系について学ぶグループアクティビティを構築したくて人々は共有ウィンドウで惑星について読む事から始められるようになっていますそしてボタンを押せばグループの没入型空間で惑星モデルをよく見ることができますどちらのケースでも人々を横に並べたいと思いますテンプレートで何ができるでしょうかデフォルトではグループの没入型空間があるアプリには Surroundテンプレートが採用され空間の原点は中央に置かれますアプリに共有されるボリュメトリックシーンがある場合も同じレイアウトが採用されますですがアプリに共有される縦型ウィンドウがあるとデフォルトで選ばれるのは Side-by-Sideテンプレートで空間の原点は共有ウィンドウの真下にありますですがテンプレート設定はいつでもグループアクティビティにふさわしいものに変えられます .conversationalテンプレートを選んだり .sideBySideテンプレートを選んだりできますし私は太陽系探索アクティビティにはこのSideBySideが良いと思います先ほどもあったようにテンプレートでの距離は共有ウィンドウのサイズによって大幅に調整されますグループの没入型空間しかない場合はどのようにして距離が適切かを確認できるのか疑問に思うかもしれませんねその解決のためにテンプレートを調整する便利な道具コンテンツエクステントがありますテンプレート設定に対する修飾子で没入型にもウィンドウベースのグループアクティビティにも使えますアプリはこの値をコンテンツの中心からポイントの一番遠いエッジまでの距離として設定しますコンテンツエクステントが設定されるとアクティブなテンプレートがこの値を取り込みアプリに相対的に人々を配置しますそれではテンプレートについて学んだことを適用して先ほどの太陽系探索アクティビティのグループセッションを構築しましょうまずは supportsGroup ImmersiveSpaceを有効化して没入している間に一緒にオブジェクトが見られるようにします次にテンプレートの設定を .sideBySideに選んで contentExtentのための修飾子も追加すれば人々は常に横並びになり共有コンテンツからの距離もきちんと適切になります良いですねそれでは人が入ったこのグループアクティビティを見てみましょうここでは私はConnorと一緒に横に並んで共有ウィンドウで惑星をあれこれ見ていますあとになって私はボタンを押しグループの没入型空間に入って土星を探索しますこのモデルの美しさに驚いている間に Connorが一緒にいないと気づき見えるのは彼の連絡先写真だけになっていますですが実際は Connorは置き去りにされまだウィンドウを見ています自分でボタンを押さなければグループの没入型空間には入れません先ほど見たように人々がグループの没入型空間に一緒にいないというのは共有コンテキストを持っていないという事ですそれでシステムは空間Personaを隠し連絡先の写真を表示しますもしお互いのPersonaがまだ見えていたら Connorは自分の見えない物に対し私が驚いているのを見て混乱するでしょうグループの没入型空間が異なる没入スタイルで表示されれば同じ状況が起こり得ます例えば私が完全没入型の環境で辺りを見回しているけれど Connorはパススルーだという場合ですですが Connorが私について来て同じグループの没入型空間に自動的に入れたらいいですよねそして私と一緒にいない時私の居場所が分かって簡単に同じ場所に来られたらと思います没入型のグループアクティビティでバラバラになるのを最小限に抑えるためにシステムコーディネータで利用できる groupImmersionStyleという素晴らしいツールがありますこのツールが提供するオプショナルな没入スタイルの非同期シーケンスはほかの人が参加するグループの没入型空間の特定の没入スタイルをアプリに伝えまたその人たちがグループの没入型空間を去るとアプリにnilと伝えます例えば私がグループの没入型空間を開くと Connorのアプリはその没入スタイルを受け取りそれと一致するスタイルでグループの没入型空間が開かれますそして一緒にグループの没入型空間に入ると再び共有コンテキストを持ちます同様に Connorがボタンを押してグループの没入型空間を去ると私のアプリはnilを受け取り没入型空間が閉じられますこのgroup immersion styleのおかげで全員がいつも一緒にいられます時には何か緊急の用事で一時的に没入型体験から抜け出たい事がありますねその場合 Digital Crownを一度押すだけでいいのですこの場合システムはほかの人たちの邪魔をしたりグループの没入スタイルを変える事もありません抜け出ると SharePlayバナーの通知が表示されてグループの残りの人たちがどこにいるか教えてくれますしグループの没入型空間に簡単に戻れる再参加のボタンも出ています「Join」ボタンをタップするとグループの没入型空間設定のためにグループの没入スタイルがアプリに送られて来ますこのセッションで随分たくさん見てきましたね復習しましょう！共有コンテキストについて学びそしてシステムコーディネータとシーンの関連付けを使ってウィンドウアプリと没入型共有アプリの両方においてどのように空間的一貫性と視覚的一貫性を管理するのかについて学びましたアプリが人々を適切に配置できるようなテンプレート設定を紹介しましたそして最後に Shareメニューを使って SharePlayを始める新しい方法も紹介しましたご視聴ありがとうございましたみなさんも是非 SharePlayで驚くような体験を開発してください ♪

4:08 - Observe the local participant state

for await session in ExploreActivity.sessions() {
    guard let systemCoordinator = await session.systemCoordinator else { continue }

    let isLocalParticipantSpatial = systemCoordinator.localParticipantState.isSpatial

    Task.detached {
        for await localParticipantState in systemCoordinator.localParticipantStates {
            if localParticipantState.isSpatial {
                // Start syncing scroll position
            } else {
                // Stop syncing scroll position
            }
        }
    }
}

6:10 - Configure the spatial template preferences

for await session in ExploreActivity.sessions() {
    guard let systemCoordinator = await session.systemCoordinator else { continue }

    var configuration = SystemCoordinator.Configuration()
    configuration.spatialTemplatePreference = .sideBySide
    systemCoordinator.configuration = configuration

    session.join()
}

9:10 - Configuring scene activation conditions

@main
struct ExploreTogetherApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .handlesExternalEvents(
                    preferring: ["com.example.explore-together.activity"],
                    allowing: ["com.example.explore-together.activity"]
                )
        }
    }
}

9:30 - Configuring scene activation conditions

class SceneDelegate: NSObject, UISceneDelegate {

    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        // ...

        scene.activationConditions.canActivateForTargetContentIdentifierPredicate =
                NSPredicate(format: "self == %@", "com.example.explore-together.activity")

        scene.activationConditions.prefersToActivateForTargetContentIdentifierPredicate =
                NSPredicate(format: "self == %@", "com.example.explore-together.activity")
    }
}

10:40 - Setting scene association behavior

struct ExploreActivity: GroupActivity {
    var metadata: GroupActivityMetadata {
        var metadata = GroupActivityMetadata()
        // ...
        metadata.sceneAssociationBehavior = .content("document-1")
        return metadata
    }
}

13:44 - Starting SharePlay

// Create the activity
let activity = ExploreActivity()

// Register the activity on the item provider
let itemProvider = NSItemProvider()
itemProvider.registerGroupActivity(activity)

// Create the activity items configuration
let configuration = UIActivityItemsConfiguration(itemProviders: [itemProvider])

// Provide the metadata for the group activity
configuration.metadataProvider = { key in
    guard key == .linkPresentationMetadata else { return nil }
    let metadata = LPLinkMetadata()
    metadata.title = "Explore Together"
    metadata.imageProvider = NSItemProvider(object: UIImage(named: "explore-activity")!)
    return metadata
}
self.activityItemsConfiguration = configuration

16:03 - Configure group ImmersiveSpace

for await session in ExploreActivity.sessions() {
    guard let systemCoordinator = await session.systemCoordinator else { continue }

    var configuration = SystemCoordinator.Configuration()
    configuration.supportsGroupImmersiveSpace = true
    systemCoordinator.configuration = configuration
}

17:51 - System Experience Displacement

// Use immersiveSpaceDisplacement to offset contents in group immersive space

var body: some Scene {
    ImmersiveSpace(id: "earth") {
        GeometryReader3D { proxy in
            let displacement = proxy.immersiveSpaceDisplacement(in: .global).inverse

            Control()
                .offset(displacement.position)
                .rotation3DEffect(displacement.rotation)
        }
    }
}

20:46 - Spatial Template Preferences

// Configure the spatial template preferences with content extent

for await session in ExploreSolarActivity.sessions() {
    guard let systemCoordinator = await session.systemCoordinator else { continue }

    var configuration = SystemCoordinator.Configuration()
    configuration.supportsGroupImmersiveSpace = true
    configuration.spatialTemplatePreference = .sideBySide.contentExtent(200)
    systemCoordinator.configuration = configuration
}

22:32 - Receive group immersion style to configure group immersive space

// Receive group immersion style to configure group immersive space

for await session in ExploreSolarActivity.sessions() {
    guard let systemCoordinator = await session.systemCoordinator else { continue }

    Task.detached {
        for await immersionStyle in systemCoordinator.groupImmersionStyle {
            if let immersionStyle {
                // Open an immersive space with the same immersion style
            } else {
                // Dismiss the immersive space
            }
        }
    }
}

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

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

リソース

関連ビデオ

WWDC23

WWDC21

WWDC19