フレンドリスト接続エラーの処理方法

Last updated on February 4, 2026

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

フレンドリストを取得する際の接続タイムアウトなどのエラーを処理することは、スムーズなプレイヤー体験を維持するために重要です。プレイヤーがフレンドリストを表示しようとしてゲームが接続の問題に遭遇した場合、適切なエラー処理により、プレイヤーがリストが更新されない理由を疑問に思うことがなくなります。この問題を処理するための効果的なアプローチをいくつか紹介します：

  • フレンドリーなエラーメッセージを表示する。フレンドリストの取得中にエラーが発生した場合、HTTPレスポンスのエラー値とメッセージに基づいて明確でフレンドリーなエラーメッセージを表示できます。
  • 手動再試行オプション。プレイヤーにフレンドリストの取得を手動で再試行するオプションを提供します。
  • 60秒ごとなど、一定の間隔でフレンドリストをポーリングする。このメカニズムがAGSソーシャルサービスに負荷をかける可能性があることに注意してください！
  • リストの更新後にフレンドリストをキャッシュする。

フレンドリスト取得リクエストエラーが適切に処理されない場合、ゲームはプレイヤー体験に悪影響を与えるいくつかの問題に遭遇する可能性があります。以下にいくつかの例を示します：

  • 無限のフレンドリスト取得プロセス：プレイヤーが終わりのないフレンドリスト取得の試行に陥る可能性があります。プレイヤーはフレンドリストを取得することができず、ローディング画面が繰り返し表示されます。
  • ゲームが空のフレンドリストを表示する。
...
    auto ABSubsystem = IOnlineSubsystem::Get(ACCELBYTE_SUBSYSTEM);
    auto FriendsInterface = ABSubsystem->GetFriendsInterface();
    int32 LocalUserNum = 0;
    
    FriendsInterface->ReadFriendsList(
        LocalUserNum, 
        TEXT(""), 
        FOnReadFriendsListComplete::CreateWeakLambda(this, [](int32 LocalUserNum, bool bWasSuccessful, const FString& ListName, const FString& Error)
        {
            if (bWasSuccessful)
            {
                // フレンドリストのクエリが成功したときに何かを実行します。
            }
            else
            {
                // 失敗したリクエストを処理するソリューションを実装します。
            }
        }
    ));
...

現在、フレンドリストの取得が失敗した場合、AGS OSSは失敗がHTTPタイムアウトによるものか、別の問題によるものかについての詳細を提供しません。 フレンドリストが更新されると、Unreal Engine AGS OSSにキャッシュされます。以下のコードは、AGS OSSのフレンドリストキャッシュを取得するためのものです：

...
    auto ABSubsystem = IOnlineSubsystem::Get(ACCELBYTE_SUBSYSTEM);
    auto FriendsInterface = ABSubsystem->GetFriendsInterface();

    TArray<TSharedRef<FOnlineFriend>> NewCachedFriendList{};
    FriendsInterface->GetFriendsList(LocalUserNum, TEXT(""), NewCachedFriendList);
...
に最終更新