グループ通知を有効にする

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

この記事では、AccelByte Gaming Services (AGS) グループサービスを使用して、ゲームクライアントがプレイヤーグループ通知を取得および配信できるようにする方法について説明します。この記事には、一般的なプレイヤーグループアクティビティのサンプル通知ペイロードも含まれています。

ゲームクライアントがグループ通知を取得および配信できるようにする

AGSでは、グループアクティビティの通知は、対象の受信者に送信されるJSON形式のペイロードとして配信されます。

ゲームクライアントがグループ通知を取得および配信できるようにするには、SetMessageNotifDelegateとOnNotification関数にコールバックを追加します。

Unreal Engine

FApiClientPtr ApiClient = AccelByteOnlineSubsystemPtr->GetApiClient();

ApiClient->Lobby.Connect();

FString NotificationTopic = "group";

ApiClient->Lobby.SetMessageNotifDelegate(AccelByte::Api::Lobby::FMessageNotif::CreateLambda([&](FAccelByteModelsNotificationMessage const& Notif)
    {
    if (Notif.Topic == NotificationTopic)
    {
        // Do something if there's a new notification under group topic
    }
    }));

Unity

AccelByteSDK.GetClientRegistry().GetApi().GetLobby().Connect();

string notificationTopic = "group";

AccelByteSDK.GetClientRegistry().GetApi().GetLobby().OnNotification += result =>
{
    if (result.IsError)
    {
        // Do something if OnNotification fails
        Debug.Log($"Error OnNotification, Error Code: {result.Error.Code} Error Message: {result.Error.Message}");
        return;
    }
    if (result.Value.topic == notificationTopic)
    {
        // Do something if there's a new notification under group topic
    }
};

サンプルペイロード

このセクションでは、さまざまな種類のグループ関連通知のサンプルペイロードを提供します。

グループ招待を受信

プレイヤーがグループへの参加に招待されたときに送信される通知のペイロードの例を次に示します:

{
  "groupName": "nameOfGroup",
  "groupId": "groupId",
  "kind": "invitation"
}

グループ参加リクエストが承認された

プレイヤーのグループ参加リクエストが承認されたときに送信される通知のペイロードの例を次に示します:

{
  "groupName": "nameOfGroup",
  "groupId": "groupId",
  "kind": "accepted-request"
}

グループ参加リクエストが拒否された

プレイヤーのグループ参加リクエストが拒否されたときに送信される通知のペイロードの例を次に示します:

{
  "groupName": "nameOfGroup",
  "groupId": "groupId",
  "kind": "rejected-request"
}

新しいグループメンバー

新しいメンバーがグループに参加したときにすべてのグループメンバーに送信される通知のペイロードの例を次に示します:

{
  "groupName": "nameOfGroup",
  "groupId": "groupId",
  "newGroupMember": "newGroupMember",
  "kind": "new-member"
}

参加リクエストの管理者通知

プレイヤーがグループへの参加をリクエストしたときにグループ管理者に送信される通知のペイロードの例を次に示します:

{
  "groupName": "nameOfGroup",
  "groupId": "groupId",
  "newGroupMember": "newGroupMember",
  "kind": "join-request"
}

新しい役割が割り当てられた

グループ管理者がプレイヤーに役割を割り当てたときに送信される通知のペイロードの例を次に示します:

{
  "groupName": "nameofgroup",
  "groupId": "groupId",
  "roleName": "Chief",
  "roleId": "roleId",
  "kind": "assigned-role"
}

役割が削除された

グループ管理者がプレイヤーから役割を削除したときに送信される通知のペイロードの例を次に示します:

{
  "groupName": "nameofgroup",
  "groupId": "groupId",
  "roleName": "Chief",
  "roleId": "roleId",
  "kind": "removed-role"
}