Copyright © 2023 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.
このドキュメントは、 Web Application Manifest仕様の補助メンバーのレジストリです。これらは アプリケーションマニフェストに追加のメタデータを提供します。このメタデータは、 デジタルストアフロントや本ウェブアプリケーションがマーケティングや配布される他の場面、またはウェブアプリケーションのインストール時のインストールダイアログの強化などに利用できます。
このセクションは、本ドキュメントの公開時点での状況を示します。現在のW3C 公開文書およびこの技術レポートの最新版は、W3C 技術レポート一覧（https://www.w3.org/TR/）で確認できます。
このドキュメントは常に進化しており、変更がコミットされるたびに新しいスナップショットを公開しています。関心のある方は変更を購読したり、manifest-app-info GitHub リポジトリで新しいマニフェストメンバーの提案も可能です。
このドキュメントは、Web Applications Working Groupによってグループノートとして ノートトラックで公開されています。
このグループノートは Web Applications Working Groupによって支持されていますが、 W3C自身およびそのメンバーによる承認ではありません。
このドキュメントはドラフトであり、随時更新・置換・廃止される可能性があります。このドキュメントを進行中の作業以外のものとして引用することは不適切です。
W3C 特許ポリシーは、 本ドキュメントにおいてライセンス要件やコミットメントを伴いません。
このドキュメントは 2023年6月12日 W3Cプロセスドキュメント によって管理されています。
ウェブアプリケーションがより多くのサービス（例えば、デジタルストアフロントや検索結果など）を通じて提供され、ネイティブアプリケーションと並んで表示されるようになるにつれて、ネイティブアプリと同様の外観で表示されることが非常に重要になっています。ウェブアプリケーションは、マニフェスト内で name や icons を定義できますが、それらのキーだけでは、ユーザーがインストールしたいかどうか判断するのに十分な情報は提供されません。ユーザーは、インストールを検討する際にアプリについての詳細情報が提供されることに慣れており、このドキュメントはそのための追加のマニフェストメンバーを定義します。
以下のメンバーは アプリケーションマニフェスト のメンバーを補完します。これらは補助的なメンバーとして分類され、実行時にウェブアプリケーションに 適用 されるものではありません（つまり、純粋に助言的であり、ユーザーエージェントが インストールされたウェブアプリケーション をどのように表示するかには影響しません）。すべてのメンバーは任意であり、以下の例のように アプリケーションマニフェスト のルートに追加できます。
{
"name": "Donate App",
"categories": ["fundraising", "donations"],
"description": "This app helps you donate to worthy causes.",
"iarc_rating_id": "e84b072d-71b3-4d3e-86ae-31a8ce4e53b7",
"screenshots": [{
"src": "images/screenshot.png",
"sizes": "800x600",
"platform": "windows",
"label": "Lots of organizations to donate to"
}]
}アプリケーションマニフェスト はJSONであるため、この仕様のメンバーはThe JSON Data Interchange Format, 2nd edition で定義される object、 array、およびstring 型です。
categories
メンバーは、ウェブアプリケーションが属するアプリケーションカテゴリを記述する
配列 であり、
文字列
の集まりです。それはウェブアプリケーションを一覧表示するカタログやストアへのヒントとして機能します。これらは最善の努力により適切なカテゴリー（またはカテゴリ）でウェブアプリケーションをリストしようとしますが、検索エンジンやメタキーワード同様に、カタログやストアがこのヒントを必ずしも尊重する必要はありません。
マニフェストの作成者は小文字の使用を推奨します。
既知のカテゴリ一覧：
追加のカテゴリを希望する場合は、manifest-app-info GitHub リポジトリ にバグ報告またはプルリクエストを送ってください。
description
メンバーは、ウェブアプリケーションの目的を開発者が説明できる 文字列
です。これは アクセシブルな説明
として機能します（インストールされたウェブアプリケーション に対して）。
iarc_rating_id
メンバーは、ウェブアプリケーションの 国際年齢評価連合（IARC） の
認証コードを示す 文字列 です。これは、そのウェブアプリケーションがどの年齢層に適切かを判断するためのものです。
IARC証明書は、配布に使用するストアを通じて取得できます。iarc_rating_id
IARCに関する詳細は IARCの仕組み や 開発者がIARCでレーティングを受けるには を参照してください。
screenshots
メンバーは、ウェブアプリケーションの一般的な利用シーンを表現する
screenshotsオブジェクト の配列です。
screenshotsオブジェクト は ImageResource オブジェクト
であり、下記の追加メンバーを持ちます。
label
メンバーは、その screenshotsオブジェクト の
文字列 であり、アクセシブルな名前として機能します。アクセシビリティの観点から、著者は各スクリーンショットに label
を記載することを推奨します。このメンバーは、レンダリングされたスクリーンショットの代替テキストとして機能します。
{
"screenshots": [{
"src": "images/screenshot.png",
"sizes": "800x600",
"form_factor": "wide",
"label": "With Software, you can select a part of your screen and take a screenshot in seconds."
}]
}
platform
メンバーは、与えられたスクリーンショットが適用される配信プラットフォームを表す
文字列
です。著者は、そのスクリーンショットが特定の状況にのみ該当する場合のみこのメンバーを使用することを推奨します。
著者は、platform は汎用的な体験を示さない場合にのみ使用してください。例えば、OS固有の platform
指定は、そのスクリーンショットにOS特有の機能が含まれている場合に限ります。
ユーザーエージェントは、表示するスクリーンショット数を自由に決められますが、自分のプラットフォームに関係ないスクリーンショット（例：Google PlayがiOS専用スクリーンショット）を表示すべきではありません。
platform が設定されていない場合、ユーザーエージェントはそのスクリーンショットがすべてのプラットフォームに適用されるとみなすべきです。
ユーザーエージェントはスクリーンショットのアスペクト比（
sizes）を基に表示するかどうか判断できます。
OS固有の platform 値一覧：
アプリ配信プラットフォーム固有の platform 値一覧：
追加のプラットフォームを希望する場合は、manifest-app-info GitHub リポジトリ にバグ報告またはプルリクエストを送ってください。
form_factor
メンバーは、そのスクリーンショットが適用されるデバイスの画面形状を表す
文字列
です。著者は、そのスクリーンショットが特定の状況にのみ該当する場合のみこのメンバーを利用することを推奨します。
form_factorは、そのスクリーンショットが汎用的な体験を示さない場合のみに使用してください。たとえば、画面の向きによってレイアウトやデザインが異なる場合は、"narrow"
または "wide" を指定するのが望ましいです。
ユーザーエージェントは表示するスクリーンショット数を自由に決められますが、自分のform
factorに該当しない（例えばモバイル端末が"wide"のform_factorスクリーンショット）ものは表示すべきではありません。
form_factor が未設定の場合、ユーザーエージェントはすべてのフォームファクターに適用されるものとします。
form_factor の値一覧：
このセクションは規範的ではありません。
著者は、本ドキュメントで定義されているすべてのテキスト文字列の内容を、Manifest仕様で概説されている手法に基づいてローカライズすることが期待されます。
Rob Dolin は本作業全体、特に iarc_rating_id メンバーの主導に尽力し、Kenneth Rohde Christiansen
はこれらのアイデアの精査にご協力くださいました。
また、次の貢献者の方々にも感謝いたします: Christian Liebel、Julien Cayzac、Marcos Cáceres、Thomas Steiner、Xiaoqian Wu、Yajing Tang。
categories
§2.1
description
§2.2
form_factor
§3.3
iarc_rating_id
§2.3
label
§3.1
platform
§3.2
screenshots
§2.4
manifest用）
manifest用）
ImageResource
sizes（ImageResource用）
Referenced in: