prefer_related_applications

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

prefer_related_applications マニフェストメンバーは、 related_applications マニフェストメンバーで指定されたネイティブアプリケーションをウェブアプリケーションよりも優先してインストールするかどうかをブラウザーに指定するためのヒントを提供するために使用されます。

構文

json
/* 論理値 */
"prefer_related_applications": true
"prefer_related_applications": false

論理値:

  • true に設定すると、ブラウザーはユーザーにウェブアプリの代わりに related_applications に掲載されているアプリケーションのいずれかをインストールするよう促すことがあります。
  • false に設定するか、省略すると、ブラウザーは関連のネイティブアプリケーションよりもウェブアプリをインストールすることを推奨します。

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

ウェブアプリのインストール環境設定を指定

Google Play Store と Windows Store の両方で、ウェブアプリとネイティブアプリの両方を保有している状況を考えてみましょう。相対するネイティブアプリをオプションとして提供したいが、ユーザーにはウェブアプリをインストールすることを推奨したい場合、下記のようにマニフェストファイルで設定することができます。 ブラウザーウィンドウにウェブアプリのインストールを促します。 ネイティブアプリは引き続き代替案として利用できます。

json
{
  "prefer_related_applications": false,
  "related_applications": [
    {
      "platform": "play",
      "id": "com.example.hiking-app"
    },
    {
      "platform": "windows",
      "url": "https://apps.microsoft.com/detail/9nqx6sv74srz"
    }
  ]
}

関連のネイティブアプリのインストールに関する環境設定を指定

ウェブアプリのマニフェストファイルを下記に示す方法で構成することで、ユーザーに、ウェブアプリよりも Google Play ストアから Android ネイティブのハイキングアプリをインストールすることを推奨することができます。

json
{
  "prefer_related_applications": true,
  "related_applications": [
    {
      "platform": "play",
      "id": "com.example.hiking-app"
    }
  ]
}

仕様書

Specification
Web Application Manifest
# prefer_related_applications-member

ブラウザーの互換性

関連情報