Teams アプリのアプリ アイコンのバッジを有効にする

  • [アーティクル]

アプリ アイコンのバッジは、会議参加者が会議中のアプリ アクティビティを識別するのに役立ちます。 参加者は、会議アプリのアクティビティ通知を受け取ります。

会議中に新しいアクティビティがあるとき、アプリは API を呼び出 targetedMeetingNotification し、会議の統合バー (U バー) のアプリ アイコンに赤いバッジを表示します。 参加者がアプリ アイコンを選択すると、会議のサイド パネルでアプリが開き、バッジが消えます。

たとえば、会議でのリアルタイムコラボレーション中に、参加者が会議に追加されたファイルにコメントを追加した場合、アプリは参加者の会議側パネルから API を呼び出 targetedMeetingNotification します。 API は、アプリ アイコンのバッジをトリガーして、他の参加者がコメント アクティビティを認識できるようにします。

次の図は、会議の U バーのアプリ アイコンのバッジを示しています。

スクリーンショットは、チーム会議の U バーのアプリ アイコンのバッジを示しています。

注:

  • アプリ アイコンのバッジは、 Government Community Cloud (GCC)-High および国防総省 (DOD) 環境では使用できません。
  • モバイル クライアントでは、アプリ アイコンのバッジはサポートされていません。
  • アプリ アイコンのバッジは、チャネル会議ではサポートされていません。

アプリ アイコンのバッジを有効にするには、次の手順に従います。

  1. アプリ アイコンのバッジのアプリ マニフェスト設定を有効にする
  2. アプリのアプリ アイコンのバッジを有効にする

アプリ アイコンのバッジのアプリ マニフェスト設定を有効にする

アプリ アイコンのバッジを有効にするには、次の手順を実行する必要があります。

  • アプリのプロパティとしてcontext構成meetingSidePanelされていることを確認します。
  • アプリ マニフェストのauthorizationフィールドのプロパティと name プロパティと type プロパティをresourceSpecific次のように構成します。

"webApplicationInfo": {
    "id": "<<MICROSOFT-APP-ID>>",
    "resource": "https://RscBasedStoreApp"  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        {
          "name": "OnlineMeetingNotification.Send.Chat",
          "type": "Application"        }
      ]
    }
  }

アプリのアプリ アイコンのバッジを有効にする

アプリ アイコンのバッジを有効にするには、 会議内通知を対象にしていることを確認します。

対象の会議通知とアプリ アイコンのバッジ API が拡張され、アプリ アイコンのアプリ アイコンのバッジ機能がサポートされ、目的の受信者のユーザー MRI ID が渡されます。 パラメーターで surfaces value がサポート meetingTabIcon されるようになりました。これはアプリで使用されます。

アプリは、同じ会議に tabEntityId追加されたアプリのインスタンスが複数ある場合は、 を渡すこともできます。 が tabEntityId 渡されない場合、Teams はユーザー会議ウィンドウの最初のアプリ アイコンにバッジを表示します。

例

サンプル コード リファレンス

TeamsInfo.SendMeetingNotificationAsync(context, notificationPayload, meetingId);

応答コード

次の表に、応答コードを示します。

応答コード 説明
202 通知が正常に送信されました。
207 通知は少数の参加者にのみ送信されます。
400 会議通知要求ペイロードの検証に失敗しました。
401 ボット トークンが無効です。
403 ボットは通知を送信できません。
404 会議チャットが見つからないか、名簿に参加者が見つかりませんでした。

制限事項

  • アプリ アイコンのバッジには、会議ごとに 1 分でユーザーに対する通知が 1 つだけ表示されます。

  • アプリ アイコンのバッジは、特定の会議の最初の 50 人の参加者に表示されます。

コード サンプル

サンプルの名前 説明 Node.js .NET
Teams アプリのアプリ アイコンのバッジ このサンプルでは、Teams アプリのアプリ アイコンのバッジを有効にする方法を示します。 表示 表示

関連項目