Teams アプリ パッケージ
アプリ パッケージは、Teams でアプリをインストールして実行するために必要なリソースを含むファイル形式であり、次のファイルが含まれている必要があります。
- アプリ マニフェスト: アプリの機能、必要なリソース、その他の重要な属性など、アプリの構成方法について説明します。
- アプリ アイコン: 各パッケージには、アプリの色とアウトライン アイコンが必要です。
Microsoft Teams アプリを配布するには、アプリ パッケージ フォルダー内のファイルを圧縮し、適切な名前を指定する必要があります。
Teams でアプリがホストされない
ユーザーが Teams にアプリをインストールすると、構成ファイル (アプリ マニフェストとも呼ばれます) とアプリのアイコンのみを含むアプリ パッケージがインストールされます。 アプリのロジックとデータ ストレージは、開発中のローカルホストや Azure Web サービスなど、他の場所でホストされます。 Teams は HTTPS 経由でこれらのリソースにアクセスします。
アプリ マニフェスト
アプリ マニフェストは、アプリの機能、必要なリソース、その他の重要な属性を含むアプリの構成を、アプリ パッケージ内の名前 manifest.json
で記述します。
アプリを作成し、次のいずれかのプラットフォームを使用してアプリ マニフェストを構成できます。
Teams Toolkit: アプリを作成、デバッグ、デプロイするための Microsoft Visual Studio Code と Visual Studio の一連のツールと拡張機能。 アプリを作成すると、選択した機能に基づいてテンプレート ファイルからアプリ マニフェストが生成されます。 その後、要件に基づいて Visual Studio Code または Visual Studio でカスタマイズし、マニフェスト ファイルを検証し、アプリ パッケージを圧縮できます。
Teams 開発者ポータル: アプリの作成、アプリ マニフェストの構成、アプリ パッケージの生成に役立つ Web ベースのプラットフォーム。 Teams 開発者ポータルを使用してアプリを作成するには、「 アプリの作成と登録」を参照してください。
ボット、タブ、メッセージ拡張機能、その他の機能をアプリに追加するには、アプリ マニフェストを必要なアプリ機能で更新します。 詳細については、「 アプリ機能を使用したアプリのビルド」を参照してください。
Microsoft Teams ストアにアプリを発行するときは、アプリ マニフェストが最新の アプリ マニフェスト スキーマを参照していることを確認します。 サンプル アプリ マニフェストについては、「 Hello world サンプル アプリ」を参照してください。
アプリのアイコン
アプリ パッケージには、アプリ アイコンの 2 つの .png バージョン (色とアウトライン バージョン) を含める必要があります。
注:
アプリにボットまたはメッセージ拡張機能がある場合、アイコンは Microsoft Azure Bot Service登録に含まれます。
アプリが Teams ストアのレビューに合格するには、これらのアイコンが次のサイズ要件を満たしている必要があります。
カラー アイコン
アイコンのカラー バージョンは、ほとんどの Teams シナリオで表示され、192x192 ピクセルである必要があります。 アイコン記号 (96 x 96 ピクセル) は任意の色にすることができますが、単色または完全に透明な正方形の背景に配置する必要があります。
Teams では、アイコンが自動的にトリミングされ、複数のシナリオで角が丸い四角形とボット シナリオの六角形が表示されます。 詳細を失わずにシンボルをトリミングするには、シンボルの周囲に 48 ピクセルのパディングを含める必要があります。
アウトライン アイコン
アウトライン アイコンは、次の 2 つのシナリオで表示されます。
- アプリが使用されていて、Teams の左側のアプリ バーで「ホスト」と表示されている場合。
- ユーザーがアプリのメッセージ拡張機能をピン留めする場合。
アイコンが 32 x 32 ピクセルであることを確認します。 透明な背景を持つ白または白い背景で透明にする必要があります。 他の色は使用できません。 アウトライン アイコンには、シンボルの周囲に追加のパディングを含めることはできません。
ベスト プラクティス
実行: 正確なアウトライン アイコンのガイドラインに従う
アイコンで使用する白の RGB 値は、赤 255、緑: 255、青: 255 である必要があります。 アウトライン アイコンの他のすべての部分は、アルファ チャネルを 0 に設定して、完全に透明にする必要があります。
しないでください: 円形または丸い四角形でトリミングする
アプリ パッケージで送信されるカラーアイコンは正方形である必要があります。 アイコンの角を丸めないでください。 Teams では、角の半径が自動的に調整されます。
しないでください: 他のブランドをコピーする
アイコンは、所有していない著作権で保護された製品を模倣してはなりません。 たとえば、Microsoft 製品やブランドに似たデザインです。
例
さまざまな Teams の機能とコンテキストでのアプリ アイコンの表示方法を次に示します。
個人用アプリ
ボット (チャネル)
メッセージ拡張機能:
次のステップ
アプリの配布方法を選択します。
関連項目
Platform Docs
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示