related_applications

related_applications

オブジェクトの配列で、それぞれがウェブアプリに関連するプラットフォーム専用のネイティブアプリケーションを表します。各オブジェクトには、 platform プロパティと、 url または id （またはその両方）の少なくとも 1 つを記載する必要があります。

platform

アプリケーションが得られるプラットフォームを識別する文字列。 例えば、amazon (Amazon App Store)、play (Google Play Store)、windows (Windows Store) などがあります。 取りうるプラットフォーム値の一覧を確認してください。

url 省略可

プラットフォーム固有のアプリケーションが得られる URL を表します。 指定しなかった場合は、 id を指定する必要があります。

id 省略可

指定したプラットフォーム上でアプリケーションを表すために使用されている ID を含む文字列。 指定しない場合は、url を指定する必要があります。

「関連アプリケーション」とは、ウェブアプリと似た機能を提供するネイティブアプリケーションで、追加機能やユーザー端末とのより優れた統合機能をよく備えています。

related_applications マニフェストメンバーを使用すると、ウェブアプリケーションに関連するプラットフォーム固有のネイティブアプリケーションを識別することができます。 例えば、 Google Play ストアで利用できる、製品の Android ネイティブアプリケーションがあるとします。 このアプリケーションはウェブアプリケーションと同じコア機能を提供し、端末の通知システムとより良く統合されているとします。 related_applications を使用すると、ウェブアプリケーションのマニフェストファイルでこの Android ネイティブアプリケーションを指定することができます。

related_applications メンバーに関する主なポイントとして、以下が含まれます。

• これにより、異なるプラットフォーム上の複数の関連アプリを指定することができ、さまざまな端末や OS 向けのネイティブアプリのオプションをユーザーに与えてくれます。

• ウェブアプリと指定したネイティブアプリの間に単一方向の関係を作成します。 ネイティブアプリは、逆にウェブアプリを参照することが要求されることはありません。

• ウェブクローラーがこのデータを使用して、自分のウェブアプリに関連するネイティブアプリに関するより多くの情報を収集し、これらのネイティブアプリの検索性を向上させる可能性があります。

• prefer_related_applications メンバーセットを true に設定して使用すると、ブラウザーがウェブアプリではなく、関連のネイティブアプリのインストールを提案として表示できるようになります。

  メモ: Chromium ベースのブラウザーでは、ウェブアプリをインストール可能にするには、prefer_related_applications を false に設定するか、省略するかします。

この例では、ウェブアプリのマニフェストファイルで関連する Android アプリを指定する方法を示します。 Google Play ストアで利用できるネイティブアプリを識別するために、最小限の情報のみを使用しています。

{
  "related_applications": [
    {
      "platform": "play",
      "id": "com.example.app1"
    }
  ]
}

Google Play ストアと Windows ストアの両方でネイティブ版のウェブアプリが利用できる場合は、ウェブアプリのマニフェストファイルに次のような指定をします。

{
  "related_applications": [
    {
      "platform": "play",
      "url": "https://play.google.com/store/apps/details?id=com.example.app1",
      "id": "com.example.app1"
    },
    {
      "platform": "windows",
      "url": "https://apps.microsoft.com/store/detail/example-app1/9WZDNCRFHVJL"
    }
  ]
}

ウェブアプリではなく、 Google App Store で利用できるネイティブアプリをインストールするオプションをユーザーに指定してほしい場合、 prefer_related_applications を true に設定します。これにより、ブラウザーはウェブアプリではなく、 Android ネイティブアプリのインストールをユーザーに促すことがあります。

{
  "prefer_related_applications": true,
  "related_applications": [
    {
      "platform": "play",
      "id": "com.example.app1"
    }
  ]
}

• prefer_related_applications マニフェストメンバー
• ウェブアプリマニフェストで、ウェブアプリをインストール可能にする
• Navigator.getInstalledRelatedApps()