Epic Online Services でできること

Epic Online Services でできること

• 1.
  Epic Online Servicesでできること Epic Games Japan Software Engineer, Developer Relations 寺内 大起
• 2.
  #UE4 | @UNREALENGINE はじめに EpicGames は全てのゲーム開発者が利用可能なプラットフォームフリーなオン ラインサービスとして Epic Online Services (EOS)を提供します。 EOSはあらゆるメジャーなプラットフォームから利用可能な様々な機能を持って おり、どのようなエンジン/ストアとも統合可能です。 本日は、EOSが提供する機能の説明及びSampleを用いて実際の動作をご紹介させ ていただきます。
• 3.
  #UE4 | @UNREALENGINE 今日のゴール EOSを使うと 何ができて、何ができないのか がイメージできる
• 4.
  #UE4 | @UNREALENGINE 目次 ●EOSとは ● SDKについて ● 具体的にできること ● まとめ
• 5.
  #UE4 | @UNREALENGINE 目次 ●EOSとは ● SDKについて ● 具体的にできること ● まとめ
• 6.
  #UE4 | @UNREALENGINE https://dev.epicgames.com/ja/services EOSとは
• 7.
  #UE4 | @UNREALENGINE 目次 ●EOSとは ● SDKについて ● 具体的にできること ● まとめ
• 8.
  #UE4 | @UNREALENGINE SDKについて DevPortal(https://dev.epicgames.com/portal/)からダウンロード可能 - C++, C#, iOS用SDKの3種類 (SDK1.7 時点) ※ 各コンソール向けSDKは別途リクエストが必要
• 9.
  #UE4 | @UNREALENGINE SDKはdll (C++) に加えてサンプルアプリケーションを含む SDK について
• 10.
  #UE4 | @UNREALENGINE SDKについて EOS SDKの設定方法からサンプルアプリケーションの実行までの手順の解説動画 https://youtu.be/NOoLPGENwrg
• 11.
  #UE4 | @UNREALENGINE SDKを呼び出す Client SDKを呼び出す際、必ずClient ID/Secretを設定する必要がある - DevPortalからClient IDの発行が可能 - Roleによって、権限が異なり、同じAPI でも出来ることが変わる場合がある Client Role 権限範囲 Game Client ローカルにログインしているユーザとしてのみ 振る舞うことが可能 Game Server ログイン不要で全ユーザの データにアクセス可能 ※Dedicated サーバでの利用を推奨
• 12.
  #UE4 | @UNREALENGINE EOSSDK の補足 Unreal Engine との連携は現状ありません - 他のゲームエンジンから利用するのと同様に、SDKをご利用ください 他プラットフォームサービスとの連携はアカウント認証のみ - 実績/ゲームセッション等、他プラットフォームの類似サービスもあります が、それらと連動はせず、独立して動作します
• 13.
  #UE4 | @UNREALENGINE 目次 ●EOSとは ● SDKについて ● 具体的にできること ● まとめ
• 14.
  #UE4 | @UNREALENGINE 提供するサービス群 EpicOnline Services ドキュメント (https://dev.epicgames.com/docs/services/ja/)
• 15.
  #UE4 | @UNREALENGINE 提供するサービス群 -で、具体的に何ができるの？
• 16.
  #UE4 | @UNREALENGINE アカウントの認証/紐付け
• 17.
  #UE4 | @UNREALENGINE ユーザ認証 オンラインサービスを利用する時、多くの場合 利用者のアカウントを認証する必要がある EOSは、様々なアカウントでの認証に対応 -Epic Games アカウントでの認証 - 外部アカウントでの認証 (Steam, etc)
• 18.
  #UE4 | @UNREALENGINE 認証の流れ SDK EOS認証/認可 サービス 外部Identity Provider (Epic, Steam, etc) EOS User サービス EOS Endpoint 1. 認証情報を提供 2. ユーザ認証 3. EOSアカウント 情報とMapping
• 19.
  #UE4 | @UNREALENGINE 認証に必要な設定 DevPortal上で、各IdentityProviderの設定を行う必要がある - Epic Games アカウント - Epic Account Services - 外部アカウント - それぞれのIdentity Providerで必要になるCredential/URL等の設定
• 20.
  #UE4 | @UNREALENGINE ユーザ認証補足 EOSでは各アカウントの情報は、製品(Product) × ユーザー単位で割り当てられ る 製品ユーザーID(Product User ID) で管理される ロ グ イ ン ロ グ イ ン ゲームA - Product User ID: ABCD ゲームB - Product User ID: 1234 Epic Games アカウント で認証 アカウントID: Terauchi
• 21.
  #UE4 | @UNREALENGINE ユーザ認証 AuthInterface - Epic Games アカウントを利用する場合 - EOS_Auth_Login() Connect Interface - Epic Games アカウント以外のアカウント (Steam 等)を利用する場合 - EOS_Connect_Login()
• 22.
  #UE4 | @UNREALENGINE 外部アカウントの紐付け ConnectInterface - 製品ユーザー ID の新規発行 - EOS_Connect_CreateUser() - 指定した外部アカウントに対応する製品ユーザIDが未作成 (= EOS_Connect_Login() でユーザが見つからなかったとき) に利用 - 既存の製品ユーザーIDへの、外部アカウント紐付け - EOS_Connect_LinkAccount () - 既存の製品ユーザIDに対して、別の外部アカウントを紐付けたい場合に利用 - EOS_Connect_Login() から取得できる Continuance Token を使う
• 23.
  #UE4 | @UNREALENGINE フレンドリスト
• 24.
  #UE4 | @UNREALENGINE フレンドリスト EpicGames アカウントを利用している場合、 そのユーザのフレンドリストを取得可能 ※ SDK1.7時点では、フレンド申請や削除等、フレンド リストを更新するAPIは全て利用不可能となっています フレンドのステータス(ログイン等)が変更され た際に通知を受け取ることが可能です
• 25.
  #UE4 | @UNREALENGINE フレンド操作 FriendsInterface - フレンドリストを取得 - EOS_Friends_QueryFriends() - フレンドのステータス変更通知を受け取る - EOS_Friends_AddNotifyFriendsUpdate()
• 26.
  #UE4 | @UNREALENGINE フレンド情報の表示 ゲーム内で実装せずとも、SocialOverlayを利 用することで、フレンドリスト及びそのステー タスを確認可能 - Shift + F3 で表示可能
• 27.
  #UE4 | @UNREALENGINE ゲーム内情報(Stats) の集計
• 28.
  #UE4 | @UNREALENGINE ゲーム内情報(Stats)の集計 DevPortal上でゲーム内情報を定義し、ゲームか ら送信することで自動的な集計を可能とする - 敵を倒した数 - ゲーム内で死んだ回数 - ミニゲームの最高得点 - ヘッドショット回数 - etc. 1ゲーム当たり最大500種類のStatsを定義可能 各ユーザ単位で集計される
• 29.
  #UE4 | @UNREALENGINE 集計出来るデータ 数値データのみ集計可能 -文字列等は未対応 クエリ時に期間指定が可能で、特定の期間内の集計値を後から取得可能 サポートしている集計方法は以下の４種類 - SUM : 合計値 (敵を倒した数, 強制切断回数, etc) - MAX : 最大値 (最高得点, etc) - MIN : 最小値 (最速ラップタイム, etc) - LATEST : 最新値 (最後に利用した装備セット, etc)
• 30.
  #UE4 | @UNREALENGINE ゲーム内情報(Stats)の集計 Stats Interface - Statsの送信 - EOS_Stats_IngestStat() - ユーザの特定期間のStatsを取得 - EOS_Stats_QueryStats() Game Server権限ならば、全てのユーザのStatsの更新/取得が可能 eg. 「イイね！」された数の計測等、他者から実行されたアクションも集計可能
• 31.
  #UE4 | @UNREALENGINE ゲーム内実績の設定/解除
• 32.
  #UE4 | @UNREALENGINE ゲーム内実績の設定/解除 ドラゴンを30体倒 した！ ラスボスを倒した！100万点以上獲得！ 1分以内に ゴールした！
• 33.
  #UE4 | @UNREALENGINE ゲーム内実績の設定/解除 DevPortalで実績(Achievement)を設定可能 - Stats を元にして自動的に実績解除が可能 eg. kill_count_dragon が 10以上なら、 実績“Dragon Slayer”を解除 - 複数のStatsを取得条件に設定することも可能 - Stats を使わない実績を作りたい場合はダミーのStatsを用意する必要有り - 別途 EOS_Achievements_UnlockAchievements() を使って解除する
• 34.
  #UE4 | @UNREALENGINE ゲーム内実績の設定/解除 AchievementInterface - 実績の定義を取得する - EOS_Achievements_QueryDefinitions() - 実績の進捗状況を取得する - EOS_Achievements_QueryPlayerAchievements() - 実績を強制的に解除する (Game Serverのみ利用可能) - EOS_Achievements_UnlockAchievements()
• 35.
  #UE4 | @UNREALENGINE 実績の表示 ゲーム内で実装せずとも、SocialOverlayを利 用することで、実績の達成状況を確認可能 - Shift + F3 で表示可能
• 36.
  #UE4 | @UNREALENGINE リーダーボード
• 37.
  #UE4 | @UNREALENGINE リーダーボード Statsを元にしたリーダーボードを作成可能 -各コースの世界最速ランキング - 世界最高スコアランキング - フレンド間でのクリアタイムランキング - etc. グローバルなリーダーボードと ユーザを指定したリーダーボードがある
• 38.
  #UE4 | @UNREALENGINE グローバルなリーダーボード 全プレイヤーを対象に、上位１０００人までを管理するリーダーボード 事前にDevPortalで定義を作成しておく必要あり - 最大50個作成可能 - Stats を指定すると、それを元に自動的にランキングが集計される - Stats の集計方法によってランキングの付け方が自動的に決定される eg. “stage_1_clear_time (MIN)” の昇順ランキング
• 39.
  #UE4 | @UNREALENGINE ユーザを指定したリーダーボード 指定したユーザのStatsを読み取って、リーダーボードの様に見せかけて返す -製品ユーザーID 及び Statsを指定してランキングを取得可能 - 同時に指定可能なユーザ数は 32人 まで - フレンド間のランキングなど、特定のユーザ間でのランキングに利用できる
• 40.
  #UE4 | @UNREALENGINE リーダーボードの取得 LeaderboardsInterface - グローバルなリーダーボード - EOS_Leaderboards_QueryLeaderboardDefinitions() - 定義の取得 - EOS_Leaderboards_QueryLeaderboardRanks() - ランキングの取得 - ユーザ指定したリーダーボード - EOS_Leaderboards_QueryLeaderboardUserScores() - ユーザ間でのランキングの取得
• 41.
  #UE4 | @UNREALENGINE ゲームセッションの検索
• 42.
  #UE4 | @UNREALENGINE ゲームセッション ここで想定しているゲームセッションとは -各ゲームにおける1プレイ単位 - 比較的短時間で終了する (数分 ~ 数時間) - 開始と終了が明確に存在している - オンラインでの複数人プレイ シューターゲームの1マッチ、レースゲームでの1レース等
• 43.
  #UE4 | @UNREALENGINE ゲームセッションの検索 古城のステージ で戦いたい！ 10人以上参加してい るセッションがいい 友達のセッションに参 加したい！ Level50以下の人 だけ参加出来るように 制限したい
• 44.
  #UE4 | @UNREALENGINE ゲームセッションの登録 ゲームセッションの情報を登録 -ホストのIP等、接続確立に必要な情報 - ゲームセッションのステータス (開始前, プレイ中) - 検索条件としてのメタデータ情報 (ステージ名, 難易度, etc) - オプションとして参加者情報 ※ 検索を可能にするだけであり、実際のゲームセッション管理、参加者の増減、 コネクション確立等はゲーム側でハンドルし、EOS側に反映する必要が有る - セッションに参加する際の手順 - 参加希望者がセッション詳細から接続先を確認 - ゲーム内でコネクション確立 - セッション所有者がセッション情報を更新
• 45.
  #UE4 | @UNREALENGINE ゲームセッションの表示 同時に複数のゲームセッションに参加可能 参加者がEpicGames アカウントの場合、 プレゼンスにゲームセッションを表示可能 (最初の１つのみ) - Social Overlay のプレゼンス表示から、 セッションへの招待/参加等が可能
• 46.
  #UE4 | @UNREALENGINE ゲームセッションの検索 SessionID による検索 - 既にIDを知っている場合の検索方法 - 招待を受けている場合、プレゼンス情報を利用する場合など 製品ユーザID による検索 - 製品ユーザID を指定し、そのユーザが参加しているゲームセッションを検索 - フレンドのゲームセッションを探したい場合など 属性値による検索 - ゲームセッションに設定されている属性値を使って検索 - ランダムに参加するセッションを検索したい場合 -
• 47.
  #UE4 | @UNREALENGINE 属性値による検索 各ゲームセッションが持つ属性情報を元に、条件検索が可能 -各属性値に対してフィルタ条件を設定可能 (組み合わせ検索可能) - 数値属性 : =, ≠ , <, >, ≦, ≧ - 文字列属性: セミコロン区切りで指定した、いずれかの文字列を含む or どれも含まない - 数値属性を利用してソート可能 - 基準数値を指定し、そこからの絶対距離でソート可能 ステージ５ 難易度はHARD 参加者の平均レベ ルで昇順ソート
• 48.
  #UE4 | @UNREALENGINE ゲームセッションの登録 SessionsInterface - セッションの作成/更新/破棄 (Game Serverのみ利用可能) - EOS_Sessions_CreateSessionModification() - EOS_Sessions_UpdateSession() - EOS_Sessions_DestroySession() - メンバー管理 (Sessionの所有者が実行する) - EOS_Sessions_RegisterPlayers() - EOS_Sessions_UnregisterPlayers()
• 49.
  #UE4 | @UNREALENGINE ゲームセッションの検索 SessionsInterface - セッションへの招待/拒否 - EOS_Sessions_SendInvite() - EOS_Sessions_RejectInvite() - セッションの検索 - EOS_SessionSearch_Find() - EOS_Sessions_CreateSessionSearch() で検索条件を指定しておく - EOS_SessionSearch_SetSessionId(): Session ID による検索 - EOS_SessionSearch_SetTargetUserId(): 製品ユーザID による検索 - EOS_SessionSearch_SetParameter(): 属性値による検索
• 50.
  #UE4 | @UNREALENGINE SessionsInterfaceの注意点 基本思想は、Dedicatedサーバなどのセッション集中管理システムが存在し、 Sessions Interfaceを呼び出す前提 - ホスト (セッション作成者)のみがセッションの状態を更新可能 - ネットワーク切断時などのホストの移譲などはサポートされていない - P2P接続で管理されるセッションでの利用には若干不向き - エラーハンドリング等が複雑になる
• 51.
  #UE4 | @UNREALENGINE ロビー管理
• 52.
  #UE4 | @UNREALENGINE ロビーとは ゲームセッションより長期的なグループ -他のユーザーとのチャット - 他のプレイヤーの参加を待機 - チームの編成 - ゲーム前のオプション選択 - etc 複数のゲームセッションを繰り返していく グループ
• 53.
  #UE4 | @UNREALENGINE ロビー バックエンド的にはゲームセッションと共有しているが、細かい違いが有る -Game Client Role でロビーが作成できる - 所有者を移譲可能 - 現所有者がLeaveした場合、自動的に新しい所有者が決定される - 参加者管理は各メンバーのJoin/Leave or Kickoutで行う - ゲームセッションの場合、所有者が責任を持って更新する必要がある - 参加者/所有者に変更があった場合、全参加者に通知が飛ぶ
• 54.
  #UE4 | @UNREALENGINE ロビー管理 LobbyInterface - ロビーの作成/更新/破棄 - EOS_Lobby_CreateSessionModification() - EOS_Lobby_UpdateSession() - EOS_Lobby_DestroySession() - ロビーへの参加/離脱 - EOS_Lobby_JoinLobby() - EOS_Lobby_LeaveLobby()
• 55.
  #UE4 | @UNREALENGINE ロビー管理 LobbyInterface - ロビーへの招待/拒否 - EOS_Lobby_SendInvite() - EOS_Lobby_RejectInvite() - ロビーの検索 - EOS_LobbySearch_Find() - EOS_Lobby_CreateLobbySearch() で検索条件を指定しておく - EOS_LobbySearch_SetLobbyId(): Session ID による検索 - EOS_LobbySearch_SetTargetUserId(): 製品ユーザID による検索 - EOS_LobbySearch_SetParameter(): 属性値による検索
• 56.
  #UE4 | @UNREALENGINE P2P接続
• 57.
  #UE4 | @UNREALENGINE P2P接続 製品ユーザーIDで指定した相手とP2P 接続の 確立、データの送受信が可能 - STUNによるNAT越えをサポート - 対称型NAT等でNAT越えに失敗した場合、 自動的にTURNサーバによるパケットリ レーに切り替えるオプションもある - パケットの到達/順序保証は、オプション で選択可能
• 58.
  #UE4 | @UNREALENGINE P2P接続 NATP2P Interface - パケットの送信 - EOS_P2P_SendPacket() - 接続が未確立の場合、コネクションリクエストが相手に通知される - コネクションリクエストの承認 - EOS_P2P_AcceptConnection() or EOS_P2P_SendPacket() - リクエストの通知は EOS_P2P_AddNotifyPeerConnectionRequest() で受付ける - コネクションの破棄 - EOS_P2P_CloseConnection()
• 59.
  #UE4 | @UNREALENGINE ユーザごとのデータストレージ
• 60.
  #UE4 | @UNREALENGINE ユーザごとのデータストレージ ゲームごとのユーザー固有のデータをオンライ ン上に保存可能 eg.デバイス間でのセーブデータ共有等 - 暗号化をサポート - 200MBのファイルまでアップロード可能 - 1人あたり最大400MBまで利用可能 現時点では、アップロードしたファイルを他のユーザと 共有することは出来ません
• 61.
  #UE4 | @UNREALENGINE ユーザごとのデータアップロード PlayerData Storage Interface - ファイル情報の取得 - EOS_PlayerDataStorage_QueryFileList() - EOS_PlayerDataStorage_QueryFile() - ファイルの読み出し/書き込み/削除 - EOS_PlayerDataStorage_ReadFile() - EOS_PlayerDataStorage_WriteFile() - EOS_PlayerDataStorage_DeleteFile()
• 62.
  #UE4 | @UNREALENGINE ゲームプレイ統計情報の送信
• 63.
  #UE4 | @UNREALENGINE ゲームプレイ統計情報の送信 ゲームのプレイ状況を送信することで、 DevPortal上から統計情報として確認可能 -現在の同時接続数 - 過去のプレイヤー数の記録 - ユーザのリテンション状況 - etc. ゲーム開始 or 終了
• 64.
  #UE4 | @UNREALENGINE ゲームプレイ統計情報の送信 MetricsInterface - プレイセッションのレポート (リテンション状況の集計に使用される) - EOS_Metrics_BeginPlayerSession() - EOS_Metrics_EndPlayerSession() - 同時接続数の収集 - オンラインのマシンでSDK の初期化を行うと自動的に集計される
• 65.
  #UE4 | @UNREALENGINE ゲームプレイ統計情報の送信 実際のDevPortalの画面
• 66.
  #UE4 | @UNREALENGINE 制限事項等
• 67.
  #UE4 | @UNREALENGINE サービスの使用上の制限事項 各サービスごとの詳細は下記を参照 https://dev.epicgames.com/docs/services/ja/DevPortal/UsageLimitations/index.html
• 68.
  #UE4 | @UNREALENGINE 目次 ●EOSとは ● SDKについて ● 具体的にできること ● まとめ
• 69.
  #UE4 | @UNREALENGINE まとめ ●EOSが提供する機能について概要を説明しました ● アカウントの認証/紐付け ● フレンドリスト ● ゲーム内情報 (Stats) の集計 ● ゲーム内実績の設定/解除 ● リーダーボード ● ゲームセッションの検索 ● ロビー管理 ● P2P接続 ● ユーザごとのデータアップロード ● ゲームプレイ統計情報の送信 ● 制限事項等
• 70.
  #UE4 | @UNREALENGINE おわりに EpicOnline Services は2020/06に正式サービスインしたばかりのプラット フォームですが、非常に早いサイクルで機能拡張が続けられています。 今後もさらなる機能追加や改善が行われていきますので、ご期待ください。 EOSは永続的に無料ですので、ぜひ皆さん一度触ってみてください！ コミュニティへの参加もお待ちしております。 https://eoshelp.epicgames.com/s/?language=en_US
• 71.
  #UE4 | @UNREALENGINE EOF