メインコンテンツまでスキップ

フレンドリクエストメニューを追加する - フレンドを追加する - (Unity モジュール)

Last updated on February 4, 2026

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

メニューの内容

このチュートリアルでは、送信または受信したフレンドリクエストを表示および処理するために使用するユーザーインターフェース(UI)を準備する方法を学びます。UI ファイルは リソース セクションで入手でき、以下で構成されています。

  • FriendRequestsMenu_Starter: 受信したフレンドリクエストを表示する UI メニュー。

    • C# ファイル: Assets/Resources/Modules/Social/FriendsEssentials/Scripts/UI/FriendRequestsMenu_Starter.cs
    • Prefab ファイル: Assets/Resources/Modules/Social/FriendsEssentials/Prefabs/FriendRequestsMenu_Starter.prefab
  • SentFriendRequestsMenu_Starter: 送信したフレンドリクエストを表示する UI メニュー。

    • C# ファイル: Assets/Resources/Modules/Social/FriendsEssentials/Scripts/UI/SentFriendRequestsMenu_Starter.cs
    • Prefab ファイル: Assets/Resources/Modules/Social/FriendsEssentials/Prefabs/SentFriendRequestsMenu_Starter.prefab
  • FriendEntry: 表示名、アバター、アクションボタンなどのフレンドリクエスト情報を表示する UI コンポーネント。

    • C# ファイル: Assets/Resources/Modules/Social/FriendsEssentials/Scripts/UI/FriendEntry.cs
    • Prefab ファイル: Assets/Resources/Modules/Social/FriendsEssentials/Prefabs/FriendEntry.prefab

これらの UI メニューの Prefab を確認して、詳細情報を参照してください。

フレンドリクエストメニュー

以下は FriendRequestsMenu_Starter.prefab のプレビューです。このメニューは送信されたフレンドリクエストを表示するために使用されます。

Friend requests widget Unity Byte Wars add friends

この Prefab で使用されるコンポーネントは、FriendRequestsMenu_Starter.cs ファイルで宣言されています。以下は、この Prefab で使用されるコンポーネントの宣言です。

[Header("Friend Request Components")]
[SerializeField] private GameObject friendEntryPrefab;

[Header("Menu Components")]
[SerializeField] private AccelByteWarsWidgetSwitcher widgetSwitcher;
[SerializeField] private RectTransform resultContentPanel;

widgetSwitcher コンポーネントは、デフォルトビュー、読み込み状態、空の結果状態、エラー状態など、メニューを異なる状態間で切り替えるために使用されます。resultContentPanel は、friendEntryPrefab を使用してエントリをインスタンス化することで、フレンドリクエストリストを表示するために使用されます。

送信済みフレンドリクエストメニュー

以下は SentFriendRequestsMenu_Starter.prefab のプレビューです。このメニューは受信したフレンドリクエストを表示するために使用されます。

Sent friend requests widget Unity Byte Wars add friends

この Prefab で使用されるコンポーネントは、SentFriendRequestsMenu_Starter.cs ファイルで宣言されています。この Prefab は、以下のコンポーネント宣言を使用します。

[Header("Friend Request Components")]
[SerializeField] private GameObject friendEntryPrefab;

[Header("Menu Components")]
[SerializeField] private AccelByteWarsWidgetSwitcher widgetSwitcher;
[SerializeField] private RectTransform resultContentPanel;
[SerializeField] private Button backButton;

widgetSwitcher コンポーネントは、デフォルトビュー、読み込み状態、空の結果状態、エラー状態など、メニューを異なる状態間で切り替えるために使用されます。resultContentPanel は、friendEntryPrefab を使用してエントリをインスタンス化することで、フレンドリクエストリストを表示するために使用されます。

フレンドエントリ

以下は FriendEntry.prefab のプレビューです。これは、表示名、アバター、アクションボタンなどの受信および送信されたフレンドリクエスト情報を表示するために使用されます。

Received friend request entry widget Unity Byte Wars add friends

Sent friend request entry widget Unity Byte Wars add friends

この Prefab で使用されるコンポーネントは、FriendEntry.cs ファイルで宣言されています。以下は、これらのコンポーネントの宣言です。

[SerializeField] private Image friendImage;
[SerializeField] private TMP_Text friendName;
[SerializeField] private Button rejectButton;
[SerializeField] private Button acceptButton;
[SerializeField] private Button cancelButton;

これらのコンポーネントを操作するために、スクリプトには以下のパブリックゲッターがあります。

public Image FriendImage => friendImage;
public TMP_Text FriendName => friendName;
public Button CancelButton => cancelButton;
public Button RejectButton => rejectButton;
public Button AcceptButton => acceptButton;

UI の準備

このセクションでは、フレンドリクエストメニューと送信済みフレンドリクエストメニューの両方の UI を準備する方法を学びます。

  1. FriendRequestsMenu_Starter.cs ファイルを開きます。LoadIncomingFriendRequests という関数が表示されます。後で、この関数を実装して、すべての受信フレンドリクエストをクエリします。

    private void LoadIncomingFriendRequests()
    {
    // TODO: Implement Load Incoming Friend Requests here.
    BytewarsLogger.LogWarning("The LoadIncomingFriendRequests method is not implemented yet");
    }
  2. FriendRequestsMenu_Starter.cs ファイルで、OnEnable() 関数を見つけます。この関数は、UI が有効になったときに呼び出されます。

    private void OnEnable()
    {
    // TODO: Define Module Wrappers and Load Incoming Friend Requests here.
    }
  3. SentFriendRequestsMenu_Starter.cs ファイルを開きます。LoadOutgoingFriendRequests という関数が表示されます。後で、この関数を実装して、すべての送信フレンドリクエストをクエリします。

    private void LoadOutgoingFriendRequests()
    {
    // TODO: Implement Load Outgoing Friend Requests here.
    BytewarsLogger.LogWarning("The LoadOutgoingFriendRequests method is not implemented yet");
    }
  4. SentFriendRequestsMenu_Starter.cs ファイルで、OnEnable() 関数を見つけます。この関数は、UI が有効になったときに呼び出されます。

    private void OnEnable()
    {
    // TODO: Define Module Wrappers and Load Outgoing Friend Requests here.
    }
  5. Unity エディターで、Assets/Resources/Modules/Social/FriendsEssentials に移動し、FriendsEssentialsAssetConfig アセットファイルを開き、Is Starter Active が true に設定されていることを確認します。

  6. エディターでゲームをプレイし、ログインして、Social > Friends Requests に移動します。ここまでの実装が成功していれば、フレンドリクエストメニューを開くことができ、以下のログが表示されます。

    [FriendRequestsMenu_Starter.cs] [LoadIncomingFriendRequests] [Warning] [79] - The LoadIncomingFriendRequests method is not implemented yet
  7. エディターでゲームをプレイしている間、Social > Sent Friend Requests に移動します。ここまでの実装が成功していれば、送信済みフレンドリクエストメニューを開くことができ、以下のログが表示されます。

    [SentFriendRequestsMenu_Starter.cs] [LoadOutgoingFriendRequests] [Warning] [79] - The LoadOutgoingFriendRequests method is not implemented yet

リソース