[Tokyo DevDays 26'] Epic Online Servicesを使い始めるために

Epic Online Services を使い始めるために Epic Games Japan Software Engineer, Developer Relations YooCheol Choe(チェ)

はじめに 自己紹介 1. Epic Games Japan / Software Engineer, Developer Relations EOS 導入・技術サポートを担当しています 2. 普段やっていること EOS 実装レビュー、不具合の切り分け 3. 今日は 「EOS をこれから触る UE 開発者」に向けて、最短ルートを案内する側です

はじめに 今日の流れ 1. EOS とは何か サービスを名前で一通り。無料 / クロスプラットフォーム / モジュール式という前提も 2. 動いているところを見る 公式サンプルを 2 クライアントで起動した画面と、そのときの実ログ 3. Dev Portal で準備する Product と Client、Sandbox と Deployment、Stat と実績の定義 4. UE から呼ぶ ini など 3 ファイルのセットアップと、全機能に共通する 4 ステップのコード ベースは公式サンプル EOS-Getting-Started です

EOS とは何か EOS とは ゲームに必要なオンライン機能を、 Epic が運用まで引き受けてくれるサービス 具体的には ログイン 実績 フレンド ランキング ロビー クラウドセーブ マッチメイキング ボイスチャット 不正対策 Fortnite を支えているのと同じ基盤が、そのまま公開されています

EOS とは何か EOS の 4 つの特徴 無料 利用料なし。CCU 課金も ホスティング費用も不要 クロス プラットフォーム ストア非依存 エンジン非依存 PC / Console / Mobile を 横断して同じ API Steam でも使えます UE 以外からも使えます 「まず試す」までのハードルが、ほぼありません モジュール式 必要な機能だけ選んで 使えます

EOS とは何か サービス構成の全体像 大きく 4 つのカテゴリに整理できます Account & Social Multiplayer Player & Game Data Trust & Safety Epic Account Services Lobbies Stats Easy Anti-Cheat Connect Sessions Achievements Player Reports Friends Peer-to-Peer Leaderboards Sanctions Presence Voice Chat Player Data Storage Overlay Title Storage

サービスマップ アカウント & マルチプレイ Epic Account Services (EAS) Epic アカウントでのログイン、フレンド、プレゼンス Connect Steam / コンソール / Device ID などを 1 つの PUID に Lobbies マッチ前の待合室。参加者と属性の変更をバックエンドが push Sessions マッチ登録 / 検索 Peer-to-Peer NAT 越えのピア間通信 Voice (RTC) Lobby に自動連動する音声チャット

サービスマップ 進行度 & ストレージ Stats 数値を積む。クライアントは加算を送るだけ Achievements Stat のしきい値到達で自動解除、または直接解除 Leaderboards グローバル / フレンド範囲のランキング Player Data Storage プレイヤーごとのセーブデータ（読み書き可） Title Storage 開発側がアップロードする読み取り専用の設定 / データ Title Storage のアップロードは Dev Portal 側 - アプリを更新せずに値を変えられます

導入事例 めっちゃカメレオン いま挙げたサービスを、実際にこう使っている例です 約 34 万 2,000 万本 超 ピーク同時接続 Steam・2026 年 6 月 累計販売本数 発売 2 週間で 1,000 万本 実質 2 名 / 約 2 ヶ月 Connect, Lobby, P2P 開発規模 使用した EOS 機能 サーバーを増設せずに、アクセスの急増をそのまま吸収しました

動いているところ 完成したものを、先に見てください 公式サンプルを 2 クライアントで起動した状態 1. 別々の EOS アカウント DevAuthTool の dev1 / dev2 でログイン 2. 同じ Lobby に入っている Lobbies が参加者を同期 3. P2P で直結 NAT 越えは EOS がやってくれる 4. 専用サーバーは 0 台 自前のホスティングなし

動いているところ もう 1 人が、同じロビーに入ってくる さきほどの画面が、どう動いていたのか - 実際のログで追えます client1（host）- 部屋が無いので自分で作り、あとは待つだけ client2（guest）- 探して、見つかったので入る 09:36:56 [FindSessions] Finding lobby. 09:37:59 [FindSessions] Finding lobby. 09:36:59 [CreateLobby] Creating lobby... 09:38:00 [HandleFindSessionsCompleted] Found lobby. 09:37:01 [HandleCreateLobbyCompleted] Lobby LobbyName created. 09:38:00 [JoinSession] Joining lobby. 09:38:01 [HandleParticipantJoined] Player joined lobby LobbyName. 09:38:02 [HandleJoinSessionCompleted] Joined lobby. そのあと、両方のログに同じ 1 行 - 上が client2、下が client1（LocalUserId と RemoteUserId が逆になっているだけ） 09:38:06 Connection established. LocalUserId=[000...bdd] RemoteUserId=[000...475] ... NetworkType=[EOS_NCT_DirectConnection] 09:38:07 Connection established. LocalUserId=[000...475] RemoteUserId=[000...bdd] ... NetworkType=[EOS_NCT_DirectConnection]

動いているところ 実績が自動で解除される ゲーム側に解除判定のコードはありません 1. ジャンプで Stat が増える ゲームが送るのは「+1」だけ - コード 1 行 2. しきい値に到達すると解除 しきい値は Dev Portal 側で定義します 3. 解除の行はログに出ません UpdateStat は失敗したときだけログを出します ログに出るのは 「返ってきた側」 だけ - 集計も解除も、バックエンドの仕事です 09:36:56 LogEOSSDK: LogEOSUI: Social Overlay: Achievements populated for (c4d...d1e). 09:39:03 LogEOSOSSTutorial: [HandleQueryLeaderboardComplete] Player Id: c4d8983a...|0002dd92..., Rank: 1 09:39:03 LogEOSOSSTutorial: [HandleQueryLeaderboardComplete] Player Id: 69330677...|00022998..., Rank: 2

動いているところ 終了して再起動すると、位置が戻る Player Data Storage によるクラウドセーブ 1. 終了時の位置を保存 ファイル名は CharacterPawnLocation - コードで指定します 2. 再起動後、同じ場所から ローカルファイルではなくクラウドから読む 3. 別の PC でも同じ 同じアカウントなら進行度がついてくる 起動直後に読み、終了直前に書く - 実ログに出るのはこの 2 行です 09:36:55 LogEOSOSSTutorial: [HandleLoginCompleted] Loading cloud data and searching for a session... 09:42:53 LogEOSSDK: LogEOSPlayerDataStorage: Promoted local scratch file to cache after successful upload to cloud storage.

Dev Portal Product 一覧 EOS の設定は、すべてこの管理画面から行います 1. Organization を作り、その中に Product を作ると出てくる画面です 2. Product = ゲーム 1 本。 この下に Client と Sandbox が並びます まずは Product を 1 つ作るところから始まります

Dev Portal Client の作成 Product の設定から Client と Client Policy を作ります 1. Client = ゲームビルドが EOS に 接続するときの資格です （ClientId / ClientSecret） 2. Client Policy で機能を選びます 使う権限だけを入れるのがおすすめ ClientSecret はリポジトリにコミットしないでください

Dev Portal 環境は、どう分けるのか ini に書く SandboxId と DeploymentId - この 2 つは役割がまったく違います 1. Sandbox = 環境のティア Product - ゲーム 1 本 Live / Stage / Dev の 3 つが並びますが、 EOS だけを使う製品で必要なのは Live Sandbox ： Live 環境ティア。EGS の配信段階に紐づく単位 2. Stage / Dev は既定で無効 製品作成時に一緒に作られ、EGS の機能を 使い始めるまでボタンが押せません Deployment ： dev Deployment ： live 開発用データ（非公開） 本番データ 3. Deployment = データの隔離単位 開発用データは Deployment を追加して分けます 開発中は、どの Deployment に書き込んでいるかを必ず意識してください

Dev Portal Sandbox と Deployment 実際のポータル画面で確認します 1. Sandbox は Live / Stage / Dev の 3 つ 押せるのは Live の行だけです 2. Live の中に Deployment が 2 つ 開発用の dev と本番用の live ini に書く SandboxId / DeploymentId は、この画面から取ります

Dev Portal Stat の定義 名前と集計方法を決めます 1. 例: NUMBEROFJUMPS を SUM で定義 2. 集計方法は SUM / LATEST / MIN / MAX の 4 つ 累計 / 最新値 / 自己ベスト 3. ゲーム側のコードには、 この名前しか出てきません 集計方法が SUM でないと、+1 を送り続けても値は 1 のままです

Dev Portal Achievement の定義 Stat のしきい値と紐づけます 1. 解除条件をポータル側に持たせます 2. ゲーム側は Stat を送るだけで よくなります ここの設定 1 つが、ゲーム側のコードを 1 行消します

どう使うか EOS を UE から呼ぶ 3 つの経路 経路 状態 いまの様子 OnlineSubsystemEOS 安定 Lyra を含むサンプルと情報が多く、出荷実績も多い。今日の内容も すべて OSSv1 OnlineServicesEOS Beta UE の新しいオンライン設計。プラグインはまだ Beta 扱い EOS SDK を直接叩く 可能 UE のネットワークに乗らない特殊要件、非 UE との共通実装 OSSv1 / OSSv2 とも Blueprint 公開はありません - Blueprint から使いたい場合はサードパーティ製プラグインになりますが、そちらは Epic のサポート対象外です EOSPlus は UE 5.7 でエンジンから削除されました（移行先は EOS + NPI）。EOSPlus 前提の古い記事に注意してください。

セットアップ 必要なのは 3 ファイルだけ 1. 2. 3. .uproject Build.cs DefaultEngine.ini プラグインを有効化する 依存モジュールを追加する EOS の設定と資格情報を書く

セットアップ 1 / 3

.uproject - プラグインを有効化
EOS_OSS_Tutorial.uproject

"Plugins": [
{ "Name": "OnlineSubsystemEOS", "Enabled": true },
{ "Name": "EOSShared",
"Enabled": true },
{ "Name": "VoiceChat",
"Enabled": true },
{ "Name": "EOSVoiceChat",
"Enabled": true }
]

手で書き足すのは、この 4 行だけ - OnlineSubsystemEOS と EOSShared、ボイスを使うなら残り 2 つ
VoiceChat / EOSVoiceChat - ボイスに必要。サンプルは EOSAntiCheat も有効化しています

エディタの Plugins 画面から入れても同じです

セットアップ 2 / 3

Build.cs - 依存モジュールと機能スイッチ
1. 公開依存 - OSS を呼ぶために必要

PublicDependencyModuleNames.AddRange(new string[] {
..., "OnlineSubsystem", "OnlineSubsystemUtils", "OnlineSubsystemEOS" });
2. 非公開依存 - ボイスと通信で使う

PrivateDependencyModuleNames.AddRange(new string[] {
"VoiceChat", "EOSVoiceChat", "EOSShared", "HTTP", "Json", ... });
3. 機能スイッチ - サンプル固有。既定は両方 0

PrivateDefinitions.Add("P2PMODE=0");
PrivateDefinitions.Add("ACMODE=0");

// 1 にすると Lobby + P2P が有効
// 1 にすると Anti-Cheat が有効

P2PMODE=0 のままだとロビーのコードは丸ごとビルドされません

セットアップ 3 / 3 DefaultEngine.ini - 4 ブロック 1. EOS を有効にして、既定のサービスにする [OnlineSubsystemEOS] bEnabled=true [OnlineSubsystem] DefaultPlatformService=EOS 2. NetDriver を差し替える - まず削除、そして追加 -NetDriverDefinitions=(DefName="GameNetDriver", DriverClassName="/Script/OnlineSubsystemUtils.IpNetDriver", ...) +NetDriverDefinitions=(DefName="GameNetDriver", DriverClassName="/Script/SocketSubsystemEOS.NetDriverEOS", ...) 3. EOS の挙動設定 [/Script/OnlineSubsystemEOS.EOSSettings] DefaultArtifactName=Client bUseEAS=True bUseEOSConnect=True 4. 資格情報 - Dev Portal からコピーして埋める +Artifacts=(ArtifactName="Client", ClientId="", ClientSecret="", ProductId="", SandboxId="", DeploymentId="", EncryptionKey="")

セットアップ Dev Portal の値と ini の対応 DefaultEngine.ini の項目 Dev Portal のどこから取るか ProductId Product 設定ページ SandboxId Sandbox 一覧 - Live / Stage / Dev DeploymentId その Sandbox 配下の Deployment - 開発用はここで分ける ClientId Client 作成時に発行 ClientSecret Client 作成時に発行（再表示不可のものは再生成） EncryptionKey ポータルでは発行されません - 自分で生成する 64 桁の 16 進数 ここが 1 文字違うと EOS の初期化そのものが失敗します

核心

パターンは 1 つだけ
ログインでもロビーでも実績でもセーブでも、この 4 ステップです

1. インターフェースを取得する

IOnlineSubsystem* Subsystem = Online::GetSubsystem(GetWorld());
IOnlineXxxPtr Xxx = Subsystem ? Subsystem->GetXxxInterface() : nullptr;
2. 完了デリゲートをバインドする

XxxDelegateHandle = Xxx->AddOnXxxCompleteDelegate_Handle(
FOnXxxCompleteDelegate::CreateUObject(this, &ThisClass::HandleXxxCompleted));
3. 非同期で呼び出す

if (!Xxx->Xxx(...)) { /* 同期的な失敗 -> ハンドルをすぐ解放 */ }
4. コールバックで結果を処理し、ハンドルを解放する

void HandleXxxCompleted(bool bWasSuccessful, ...)
{
/* ... */
Xxx->ClearOnXxxCompleteDelegate_Handle(XxxDelegateHandle);

}

核心 サンプルのコメントにも、そう書いてあります "All functions that access the OSS will have this structure: 1-Get OSS interface, 2-Bind delegate for callback and 3-Call OSS interface function ..." - EOSPlayerController.cpp:345 2 番目の Bind delegate だけ、渡し方が 2 通りあります Add / Clear ...Delegate_Handle 型 先に登録してハンドルを保管し、コールバックで解放します - ログイン、セッション、ファイル書き込みなど 呼び出しの引数で渡す型（per-call） 登録も解放も要りません - UpdateStats / WriteAchievements / ReadFriendsList / SetPresence / QueryReceipts / Checkout など どちらの型かは、インターフェースのヘッダで引数を見れば分かります

モジュール 1 ログイン - EAS と EOS Connect Epic Account Services EOS Connect ・Epic アカウントでのログイン ・Steam / コンソール / Device ID を束ねる ・フレンド、プレゼンス、オーバーレイ ・1 人 = 1 つの PUID になります ・Epic のソーシャル機能が使えます ・ゲーム機能（Lobby / Stats 等）の主体 PUID (Product User Id) = EOS の中でのプレイヤー ID。P2P の接続先アドレスにもこの ID を使います

モジュール 1

ログイン - 呼ぶ側
1. インターフェースを取得
IOnlineSubsystem* Subsystem = Online::GetSubsystem(GetWorld());
IOnlineIdentityPtr Identity = Subsystem->GetIdentityInterface();
2. 完了デリゲートをバインド
LoginDelegateHandle = Identity->AddOnLoginCompleteDelegate_Handle(
0, FOnLoginCompleteDelegate::CreateUObject(
this, &ThisClass::HandleLoginCompleted));
3. 非同期で呼び出す
// 起動引数（-AUTH_TYPE=... ）を見て自動でログインしてくれる
if (!Identity->AutoLogin(0)) { /* 失敗 -> ハンドル解放 */ }

AutoLogin は非同期です。この直後はまだログインしていません

モジュール 1

ログイン - 受け取る側
EOSPlayerController.cpp:391

void AEOSPlayerController::HandleLoginCompleted(
int32 LocalUserNum, bool bWasSuccessful,
const FUniqueNetId& UserId, const FString& Error)
{
if (bWasSuccessful)
{
// ここから先で、やっと他の EOS 機能を呼べる
SetupNotifications();
}
// 4. 成否にかかわらずハンドルを解放する
Identity->ClearOnLoginCompleteDelegate_Handle(0, LoginDelegateHandle);
}

すべての EOS 機能は、ここが成功してから始めます

モジュール 1 開発中のログイン - DevAuthTool 1. Epic アカウントで一度ログインする 2. Credential Name を付けて保存 （dev1 / dev2） 3. エディタ側は起動引数で その名前を指定する エディタ / クライアントの起動引数 -AUTH_TYPE=developer -AUTH_LOGIN=localhost:8081 -AUTH_PASSWORD=dev1

モジュール 1 DevAuthTool は何を代行しているか 代行するのは認証だけです - Artifact の指定は自分で書きます 出荷（EGS 経由） 開発中（DevAuthTool） 認証 -AUTH_TYPE=exchangecode - Launcher が渡す -AUTH_TYPE=developer - ツールが代行 Artifact -epicapp - Launcher が渡す -epicapp - 代行なし。自分で書く 1. credential 1 個 = Epic アカウント 1 個 ローカルで 2 人分を検証するには、別の Epic アカウントを 2 つ用意します 2. 起動引数はプロセスごとに 1 つ ウィンドウを 2 つではなく、プロセスを 2 つ立ち上げます 3. ツールなしでも動きます bPreferPersistentAuth=True なら初回だけブラウザ認証 - 1 人で確認するならこれで十分です

動きを読む コードとログを対応させる - ホスト側 右の列は実ログからの引用です（LogEOSOSSTutorial=VeryVerbose 設定済み） コード 実際に出るログ Identity->AutoLogin(0) [Login] Logging into EOS via AutoLogin. HandleLoginCompleted [HandleLoginCompleted] Login succeeded - Player c4d8983a...|0002dd92... Session->FindSessions(0, Search) [FindSessions] Finding lobby. 検索結果 0 件 -> CreateLobby() （ログなし - ここで作成側に分岐します） Session->CreateSession(...) [CreateLobby] Creating lobby... HandleCreateLobbyCompleted [HandleCreateLobbyCompleted] Lobby LobbyName created. ゲスト側は 4 行目から先が JoinSession -> ClientTravel に変わるだけです

動きを読む 参加・退出はホストに通知される バインドするデリゲート 実際に出るログ AddOnSessionParticipantJoinedDelegate_Handle [HandleParticipantJoined] Player joined lobby LobbyName. AddOnSessionParticipantLeftDelegate_Handle [HandleParticipantLeft] Player left lobby LobbyName. ポーリングは不要 - バックエンドから push されます。参加者リストの UI はこれで更新します 登録はログイン成功後 - HandleLoginCompleted の中でバインドします 解放を忘れない - EndPlay で Clear...Delegate_Handle を呼びます

モジュール 2

Stats - 数値を積む
1. インターフェースを取得

IOnlineStatsPtr Stats = Subsystem->GetStatsInterface();
2. 更新内容を組み立てる

FOnlineStatsUserUpdatedStats UpdatedStats{ UserId.ToSharedRef() };
UpdatedStats.Stats.Add("NUMBEROFJUMPS",
FOnlineStatUpdate{ 1, ...::Unknown });
// 集計方法は Dev Portal 側
3. 呼び出す - ここは型の「例外」でコールバックを直接渡す

Stats->UpdateStats(UserId.AsShared(), { UpdatedStats },
FOnlineStatsUpdateStatsComplete::CreateWeakLambda(this,
[this](const FOnlineError& Result) { /* ... */ }));

クライアントが送るのは「+1」だけ。判定はバックエンドです

モジュール 2

Achievements - 自動解除と直接解除
EOSPlayerState.cpp:164 付近
IOnlineAchievementsPtr Achievements = Subsystem->GetAchievementsInterface();
// 直接解除する場合 - Properties の「キー」だけが ID として使われる
FOnlineAchievementsWriteRef WriteObject =
MakeShared<FOnlineAchievementsWrite, ESPMode::ThreadSafe>();
WriteObject->Properties.Add(AchievementId, FVariantData());
// 値は未使用
Achievements->WriteAchievements(*UserId, WriteObject,
FOnAchievementsWrittenDelegate::CreateUObject(
this, &ThisClass::HandleAchievementsWritten));
自動解除 - Dev Portal で Stat のしきい値を設定しておけば、ゲーム側の解除コードは不要
直接解除 - ストーリー進行など、Stat で表せない条件のときに使う

モジュール 2 Leaderboards - グローバルとフレンド 1. グローバル - 順位の範囲で取る IOnlineLeaderboardsPtr Leaderboards = Subsystem->GetLeaderboardsInterface(); FOnlineLeaderboardReadRef ReadRef(new FOnlineLeaderboardRead()); ReadRef->LeaderboardName = "JUMPERLEADERBOARD"; Leaderboards->ReadLeaderboardsAroundRank(0, 10, ReadRef); // 上位 10 件 2. フレンド範囲 - 対象ユーザーの配列を渡す Leaderboards->ReadLeaderboards(FriendUserIds, ReadRef); // ReadLeaderboardsForFriends() は UE 5.8 では使えません（後述） Stats -> Achievements -> Leaderboards は 1 セットで設計します

モジュール 4

ロビーを作る
1. インターフェースを取得してデリゲートをバインド

IOnlineSessionPtr Session = Subsystem->GetSessionInterface();
CreateLobbyDelegateHandle = Session->AddOnCreateSessionCompleteDelegate_Handle(
FOnCreateSessionCompleteDelegate::CreateUObject(
this, &ThisClass::HandleCreateLobbyCompleted));
2. 設定を組み立てる（次のスライドで詳しく）

TSharedRef<FOnlineSessionSettings> Settings = MakeShared<FOnlineSessionSettings>();
Settings->NumPublicConnections = 3;
Settings->bShouldAdvertise
= true;
3. 呼び出す

if (!Session->CreateSession(0, LobbyName, *Settings)) { /* 失敗時の解放 */ }

「Session」インターフェースでロビーを作ります - 名前に注意

モジュール 4 この 4 行が、ロビーの性格を決めます CreateLobby() の中の設定 Settings->bIsDedicated = false; Settings->bUseLobbiesIfAvailable = true; Settings->bUseLobbiesVoiceChatIfAvailable = true; Settings->bUsesPresence = true; // Session ではなく Lobby になる // ボイスも有効になる（今日は扱いません） // フレンドから参加できる bUseLobbiesIfAvailable - 同じ API で、裏側が Sessions から Lobbies に切り替わります bUsesPresence - フレンドリストやオーバーレイから、そのまま参加できるようになります 専用サーバーを使うかどうかも、1 行目のフラグ 1 つです

モジュール 4 探して、入って、繋がる 1. 接続文字列を解決する FString ConnectString; Session->GetResolvedConnectString(SearchResult, NAME_GamePort, ConnectString); 2. 検索結果は「値コピー」で保持する // 参照で持つとダングリングする - ハマりやすい箇所 SessionToJoin = SearchResult; 3. ClientTravel - 宛先は IP:Port ではなく PUID ClientTravel(ConnectString, ETravelType::TRAVEL_Absolute); 09:38:02 LogNet: Browse: EOS:0002dd92.../Game/ThirdPerson/Maps/ThirdPersonMap 09:38:06 LogEOSP2P: Connection established. NetworkType=[EOS_NCT_DirectConnection]

モジュール 6

フレンドとプレゼンス
1. フレンド一覧を読む - 型は同じ

IOnlineFriendsPtr Friends = Subsystem->GetFriendsInterface();
Friends->ReadFriendsList(0, EFriendsLists::ToString(EFriendsLists::Default),
FOnReadFriendsListComplete::CreateUObject(this, &ThisClass::HandleRead));
// コールバックが返ってから GetFriendsList() で取り出す
2. 自分の状態を公開する

FOnlineUserPresenceStatus Status;
Status.State
= EOnlinePresenceState::Online;
Status.StatusStr = TEXT("ThirdPersonMap で対戦中");
Presence->SetPresence(*UserId, Status, /* 完了デリゲート */);

フレンドリーダーボードは、この一覧をそのまま土台にしています

モジュール 6 ソーシャルオーバーレイ - 開くのは 1 行 1. フレンド一覧とオンライン状態 UI は EOS 側が持っています ゲーム側の実装は 0 行 2. ゲームへの招待をここから送る 招待は EOS 側が送ります ゲームから送るなら SendSessionInviteToFriend 3. 受け取った側は、そのままロビーへ OnSessionUserInviteAccepted -> JoinSession External->ShowFriendsUI(0); - オーバーレイを出すコードは、これだけです

モジュール 7 Title Storage - 配信後に値を変える LoadTitleData() - EOSPlayerController.cpp:1722 IOnlineTitleFilePtr TitleFile = Subsystem->GetTitleFileInterface(); // 1. まずファイル一覧を列挙する TitleFile->EnumerateFiles(); // 2. 一覧が返ってきたら、必要なファイルを読む TitleFile->ReadFile(FileName); 読み取り専用 - 開発側が Dev Portal からアップロードします 使いどころ - イベント日程、バランス調整値、緊急のお知らせ タグを一致させる - ini の +TitleStorageTags と Dev Portal 側のタグを揃えます

モジュール 7 Player Data Storage - クラウドセーブ 1. 保存 - 位置をシリアライズして書き込む IOnlineUserCloudPtr UserCloud = Subsystem->GetUserCloudInterface(); TArray<uint8> Data; FMemoryWriter Writer(Data); Writer << Location; UserCloud->WriteUserFile(*UserId, FileName, Data); 2. 読み込み - Title Storage と同じ「列挙 -> 読む」 UserCloud->EnumerateUserFiles(*UserId); // まず一覧 UserCloud->ReadUserFile(*UserId, FileName); // コールバックの後で GetFileContents() を呼ぶ UserCloud->GetFileContents(*UserId, FileName, LoadData); サンプルは FVector 1 つだけを保存しています。実際のゲームでは USaveGame 派生クラスを使ってください。

まとめ ここまでが、サンプルで動かせる範囲です ロビーを作って、参加して、 同じマップで合流する フレンド一覧とゲームへの招待 （オーバーレイ） Stat の加算から実績が 自動で解除される 同じリポジトリに、今日触れなかったものも入っています Ecom（ストアと購入） / Sessions（専用サーバー） / プレイヤー通報 / 制裁の照会 / Easy Anti-Cheat / 専用サーバーのボイス 書き方はどれも同じです。今日の型が、そのまま読む手がかりになります 終了時の位置がクラウドに残り、 次の起動で戻る

まとめ よく詰まるところ 1〜3 1. ログインのコールバック前に EOS を呼んでしまう 原因 - AutoLogin は非同期です。HandleLoginCompleted が成功してから始めてください 対処 - GetLoginStatus(0) == ELoginStatus::LoggedIn で守る 2. DefaultEngine.ini の Artifacts が空のまま 原因 - リポジトリにコミットされている値は全部空文字です 対処 - Dev Portal から 6 項目をコピー。DefaultArtifactName と名前を一致させる 3. NetDriver の差し替えを「+」だけで済ませてしまう 原因 - BaseEngine.ini の IpNetDriver が先にマッチします（first-match） 対処 - 必ず「-」で削除してから「+」で追加する

まとめ よく詰まるところ 4〜5 4. ロビーのコードが丸ごとビルドされない 原因 - Build.cs の P2PMODE が既定で 0 になっています 対処 - P2PMODE=1 にしてリビルド。ACMODE とは独立です 5. オーバーレイ関連がエディタで動かない 原因 - EOS オーバーレイは PIE では制限があります 対処 - Ecom のチェックアウトなどはパッケージ済み Win64 クライアントで検証する この 6 項目は 1 枚のチェックリストとして配布します。セットアップで止まったら、まずここを見てください。

まとめ よく詰まるところ 6 - Policy にない機能は呼べない 6. 起動しただけで赤い 403 のエラーが数行出る 原因 - Client Policy に ecommerce の権限が入っていないので、バックエンドが呼び出しを拒否しています 対処 - 使う機能なら Dev Portal で権限を追加。使わない機能なら、このエラーは無視して構いません Ecom を使わない設定のまま起動したときの実ログ 09:36:55 LogEOSSDK: Warning: Error response received from backend. ServiceName=[Ecommerce], OperationName=[GetOffersForEpicAccount], Url=[<Redacted>], HttpStatus=[403], ... ErrorMessage=[Sorry, it appears that your client is missing the required [ecommerce] policy to call this API.], ... 09:36:55 LogOnline: Error: EOS: [FOnlineStoreEOSV2::QueryOffers] result code (EOS_AccessDenied) 09:36:55 LogEOSOSSTutorial: Error: [HandleQueryStoreOffersCompleted] Failed: result code (EOS_AccessDenied) バックエンドのエラーは ServiceName と ErrorMessage だけ読めば原因が分かります

まとめ ここから始められます 写真を撮る時間を取ります 公式サンプル github.com/EpicGames/EOS-Getting-Started 今日見たコードは、すべてこのリポジトリの中にあります EOS ドキュメント dev.epicgames.com/docs/epic-online-services サービスごとの解説とインターフェース仕様 Dev Portal dev.epicgames.com/portal Product / Client / Sandbox の作成と、実績・統計の定義 EOS Status status.epicgames.com 「急に繋がらない」ときに、まずここを見てください

Thank you ご清聴ありがとうございました