アプリのディープリンク

更新日時: 2026/03/19

This is a Platform SDK feature requiring Data Use Checkup

この機能や他のPlatform SDK機能を利用するには、データの使用状況の確認(DUC)を完了する必要があります。DUCは、開発者ポリシーを遵守していることを確認するためのものです。チームの管理者は、ユーザーデータの利用がプラットフォームガイドラインに沿っていることを証明する必要があります。アプリレビューチームがDUCを審査して承認するまで、プラットフォームの機能はテストユーザーのみが利用可能です。

アプリのディープリンクにより、ユーザーを直接別のアプリで起動することができ、そのアプリの特別イベントやゲームプレイモードで直接起動するように設定することができます。

例えば、シングルプレイヤー用とマルチプレイヤー用の2つの異なるアプリがあるとします。両方のアプリにアプリのディープリンクを実装すると、ユーザーは、シングルプレイヤー用アプリからマルチプレイヤーセッションに参加することができます。

ディープリンクのためには、リクエスト元のアプリとターゲットアプリの両方に統合が必要です。次のセクションでは、両方のアプリに必要な実装について説明します。

アプリ間のディープリンクを使って収益化することは許可されていません。詳細は、アプリポリシートピックのクロスアプリリンクをご覧ください。

リンクへのアクセスに関しては、情報に基づいたユーザーの同意を得る必要があります。クロスアプリリンクを行う場合は、例えば、リンク先アプリのコンテンツ評価、無料か有料か、マルチプレイヤー機能や音声通信の有無、共有されるユーザー情報、13歳未満のユーザーに保護者の承認が必要かどうかを明確に提示する必要があります。

加えて、第三者とのデータ共有を制限する、Metaの開発者データ使用ポリシーに準拠する必要があります。例えば、ユーザーIDをリンク先アプリと共有した場合、そのアプリはユーザーIDを受け取る側としてデータの使用状況の確認の対象になります。この状況を回避するため、リンク先アプリがすでにデータの使用状況の確認の対象になっていない場合は、セッションIDのみを共有することをおすすめします。

リクエスト元アプリの実装

リクエスト元アプリは、LaunchOtherAppメソッドを呼び出して、もう一方のアプリを起動します。

Application.LaunchOtherApp(appId, deeplink_options)

このメソッドによって、ユーザーのライブラリにある別のアプリが起動されます。ユーザーがそのアプリをインストールしていない場合は、Meta Horizonストアのそのアプリのページが表示されます。

パラメーター:

パラメーター	説明
`appID`	起動するアプリのIDです。
`deeplink_options`	このリクエストの追加の構成です。任意。

例えば、Unityアプリからのリクエストは次のようになります。

var options = new ApplicationOptions();
options.SetDeeplinkMessage("abc");
Application.LaunchOtherApp(appId, options);

リクエストが行われたら、ターゲットアプリが正常に起動されたかどうかを確認する必要があります。リクエストは、ユーザーがターゲットアプリを利用する資格があり(所有しており)、すでにインストールしている場合にのみ成功します。アプリの所有者ではないかアプリをダウンロードしていないユーザーは、2Dストアの製品情報ページに誘導され、そこでアプリを購入してダウンロードできます。

注: Link PC-VRのみ - ターゲットアプリが正常に起動されたという通知を受け取った後、自分でリクエスト元アプリを終了しないと、ターゲットアプリが続行されません。

Horizonワールドの起動

注: ターゲットアプリをHorizonワールドに設定することができます。この場合は、Horizon Worldsアプリが起動して、ターゲットのワールドが読み込まれます。これを行うには、以下のステップを実行します。

AppIDパラメーターを、ハードコードされたHorizon WorldsアプリID (2532035600194083)に設定します。

FOvrApplicationOptionsオブジェクトで、値が"together://world_builder/wb_visit?world_id=<TargetHorizonWorldID>"のDeeplinkMessageを使います。<TargetHorizonWorldID>は、読み込まれるワールドのIDです。

FOvrApplicationOptionsオブジェクトで、値が<TargetHorizonWorldID>のDestinationApiName値を使います(ディープリンクメッセージのworld_idパラメーターと同じHorizonワールドID)。

受信側アプリの実装

アプリ

Application.LaunchOtherApp(appId, deeplink_options)

によって起動されたアプリは通常どおりに起動しますが、メッセージキューに

Notification_ApplicationLifecycle_LaunchIntentChanged

というタイプの通知をメッセージキューで受け取ります。

Unityアプリの開始時に、この通知を確認し、ApplicationLifecycle.GetLaunchDetails()を呼び出してアプリの起動方法に関する情報を取得します。

このAPIによって生成される通知はすべて、起動タイプがDEEPLINKになります。この情報を使って、ユーザーを適切なアプリの場所に誘導することができます。

ユーザーがLink PC-VRデバイスを使っておりアプリを所有していない場合、LaunchOtherAppリクエストはエラーを返します。このエラーは、コードで適切に処理する必要があります。ユーザーがアプリを所有している場合は、ターゲットアプリが正常に起動されたという通知を受け取った後、コードで発信側アプリを終了しないと、ターゲットアプリが続行されません。

Meta Questのデバイスを使っており、アプリの所有者ではないかアプリをダウンロードしていないユーザーは、ストアの製品情報ページに誘導され、そこでアプリを購入してダウンロードできます。