前回の続き。
お約束 | |
---|---|
この記事作成にあたって使用した主なUnreal Engine バージョン | UE 5.1.1 |
本日のゴール
EOSでStatとAchievementを実装する
StatsとAchievementの関連性
Statsが決められた数字に達した時にAchievementが与えられます。
例えば勝利数が100になったら、「100勝」というAchievementを与えたり、敵の撃破数が千人になったら「一騎当千」というAchievementを与えたり。
こんなわけで、Statsが標準で対応している型はint32です。(どんなわけや)
Statsを作る
EOSのDeveloper PortalでまずStatsを作ります。
データの種類を選ぶ欄がありますが、基本はSUMで大丈夫です。
SUM-> 後ほどアップロードした数字を 追加 していくモード。決して減ることがないStatsはこれでいいです。(バトルした回数など)
LATEST -> 最新のデータを保存するSTATS。例えば最後にログインした日など。INTに変換しないといけませんが。
MIN -> 一番低いデータを保存するSTATS。MAXは最大。
最も重要なこと。STATSの名前は必ず、全て大文字にしましょう。
「Test」はだめで「TEST」ならOKです。大文字でないと、エラーが出ます。数字は入れてもOKです。
EOS実装のおさらい
①オンラインサブシステムを取り出すOnline::GetSubsystem(this->GetWorld());
②オンラインサブシステムから各ポインタを取り出す (①を省略して直接取り出しても良い)
③取り出したポインタから、各関数を呼び出して機能を実装する
Statsの研究
Statsを取り出すポインタを検索すると、どうやら下記のようです。
ポインタ↓
- IOnlineStatsPtr GetStatsInterface() const
そして、上記ポインタを取り出すためのファンクションは下記↓
- IOnlineSubsystem::GetStatsInterface()
組み合わせると、下記のような感じになります。
- IOnlineStatsPtr StatRef = Online::GetStatsInterface(GetWorld());
ここから、ファンクションを取り出せばいいという流れは前回の通りです。
実際にVisual Studioに入れると、候補が出てくるので、そこから調べることができます。
それっぽいのはGetStats / QueryStats / UpdateStatsですかね?
(ていうかこんなアナログな調べ方が本当に正しいのか、わからんですが。。。みんなこんな調べ方してるんですかね?)
ということで、UpdateStatsを呼び出して定義に飛んでやります。するとこんな定義が書いてあります。
- virtual void UpdateStats(
- const FUniqueNetIdRef LocalUserId,
- const TArray<FOnlineStatsUserUpdatedStats>& UpdatedUserStats,
- const FOnlineStatsUpdateStatsComplete& Delegate
- ) override;
ちなみに私は上記を見ても何を引数に入れればいいのかちんぷんかんぷんです。(C++分からないので)
手探りでやっていくしかない。(オイ)
多分ですけど、今までの流れからも①ユーザーID ②アップデートするStatsの対象(FOnlineStatsUserUpdatedStats) ③デリゲート関数(FOnlineStatsUpdateStatsComplete&)を引数として入れてやればいいはず。
実際のコードを見てみる
過程は吹っ飛ばして結果だけ見ていきましょう。
まず必要なライブラリをロードしておきます。下記の一番下の行をCommonSessionSubsystem.hの最初の方に追加します。
- #if COMMONUSER_OSSV1
- #include "OnlineSubsystemTypes.h"
- #include "Interfaces/OnlineSessionInterface.h"
- #include "Public/OnlineSessionSettings.h"
- #include "Interfaces/OnlineStatsInterface.h" //<-----Add
同じファイルに下記を追加。「ChangeStats」という関数を作ります。
- /** StatChange */
- UFUNCTION(BlueprintCallable, Category = Session)
- void ChangeStats(FString StatsName, int32 StatsNumber);
- void OnChangeStatsComplete(const FOnlineError& ErrorDaze);
CommonSessionSubsystem.cppに下記を追加。「ChangeStats」という関数を実装します。
- void UCommonSessionSubsystem::ChangeStats( FString StatsName, int32 StatsNumber)
- {
- UE_LOG(LogTemp, Warning, TEXT("Stats Update Start Daze"));
- IOnlineIdentityPtr IdentityPointerRef = Online::GetIdentityInterface(GetWorld());
- check(IdentityPointerRef);
- IOnlineStatsPtr StatRef = Online::GetStatsInterface(GetWorld());
- check(StatRef);
- FOnlineStatsUserUpdatedStats StatsDaze = FOnlineStatsUserUpdatedStats(IdentityPointerRef->GetUniquePlayerId(0).ToSharedRef());
- StatsDaze.Stats.Add(StatsName, FOnlineStatUpdate(StatsNumber, FOnlineStatUpdate::EOnlineStatModificationType::Unknown));
- StatRef->UpdateStats(IdentityPointerRef->GetUniquePlayerId(0).ToSharedRef(), {StatsDaze}, FOnlineStatsUpdateStatsComplete::CreateUObject(this, &UCommonSessionSubsystem::OnChangeStatsComplete));
- }
- void UCommonSessionSubsystem::OnChangeStatsComplete(const FOnlineError& ErrorDaze)
- {
- if (ErrorDaze.bSucceeded) {
- UE_LOG(LogTemp, Warning, TEXT("Stats Update Complete Yooo %s"), *ErrorDaze.ToLogString());
- }
- else {
- UE_LOG(LogTemp, Warning, TEXT("Stats Update Failed!!!"));
- }
- }
っ何が何だかな感じですが、5-8行目はいつものポインタの取得と、チェックです。
10-13行目が何?って感じですが
FOnlineStatsUserUpdatedStatsこれがスタッツの上書きには必要なので、これを作ります。
このFOnlineStatsUserUpdatedStatsには、いつものユーザー情報(TSharedのFUniqueID)と、スタッツの名前、スタッツに書き込む情報が要ります。
11行目がそれです。末尾のUnknownはSumとかにできます。UnknownにしておくとEOS側でそれぞれのStatsに対して登録した設定で書き込みされるみたいです。
※Sumだと書き込んだ数字を足します
13行目、これで書き込んでます。
書き込み結果をどうやって、確認するのか?これが分からなくてえらい苦労しました。(公式に聞いてしまいました、回答来て神です。)
まずはDeveloper PortalのStatsのページを開きますと、このような不穏なボタンがあり、こちらをクリックするとGetの方も実装していく。
CommonSessionSubsystem.hの#include郡の下に、下記を追加。Getが完了したことを表すデリゲートの準備です。
- DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FStatsDataStream, FString, StatsName, int32, StatsValue);
- DECLARE_DYNAMIC_MULTICAST_DELEGATE(FFaliledToLoadData);
CommonSessionSubsystem.hに下記を追加
- /** StatChange */
- UFUNCTION(BlueprintCallable, Category = Session)
- void ChangeStats(FString StatsName, int32 StatsNumber);
- void OnChangeStatsComplete(const FOnlineError& ErrorDaze);
- /** StatGet */
- UFUNCTION(BlueprintCallable, Category = Session)
- void GetStatsValue(APlayerController* JoiningPlayer, APlayerController* TargetPlayer, FString StatsName);
- UPROPERTY(BlueprintAssignable, Category = Session)
- FStatsDataStream GottenStatsData;
- void OnQueryPlayerStatsComplete(const FOnlineError& ErrorDaze, const TArray<TSharedRef<const FOnlineStatsUserStats>>& UsersStatsResults);
CommonSessionSubsystem.cppに下記を追加
- void UCommonSessionSubsystem::GetStatsValue(APlayerController* JoiningPlayer, APlayerController* TargetPlayer, FString StatsName)
- {
- UE_LOG(LogTemp, Warning, TEXT("Get Stats Starts"));
- check(JoiningPlayer);
- ULocalPlayer* LocalPlayer = JoiningPlayer->GetLocalPlayer();
- ULocalPlayer* Target = TargetPlayer->GetLocalPlayer();
- IOnlineStatsPtr StatRef = Online::GetStatsInterface(GetWorld());
- check(StatRef);
- StatRef->QueryStats(LocalPlayer->GetPreferredUniqueNetId().GetUniqueNetId().ToSharedRef(), {Target->GetPreferredUniqueNetId().GetUniqueNetId().ToSharedRef()}, { StatsName }, FOnlineStatsQueryUsersStatsComplete::CreateUObject(this, &UCommonSessionSubsystem::OnQueryPlayerStatsComplete));
-
- }
- void UCommonSessionSubsystem::OnQueryPlayerStatsComplete(const FOnlineError& ErrorDaze, const TArray<TSharedRef<const FOnlineStatsUserStats>>& UsersStatsResults)
- {
- if (ErrorDaze.WasSuccessful()) {
- UE_LOG(LogTemp, Warning, TEXT("Stats Acquire"));
- for (auto StatsNum : UsersStatsResults) {
- for (auto StoredVaue : StatsNum->Stats) {
- FString KeyName = StoredVaue.Key;
- int32 WantValue;
- StoredVaue.Value.GetValue(WantValue);
- GottenStatsData.Broadcast(*KeyName, WantValue);
- }
- }
- }
- else {
- UE_LOG(LogTemp, Warning, TEXT("Stats Get Failed!!!"));
- }
- }
Getの方も基本は同じなので割愛しますが、
面白いなと思ったのは、スタッツを読むプレイヤーと、スタッツを読まれるプレイヤー(上で言うターゲット)を指定できるんですね。
12行目でQueryStatsを起動してStatsの起動をしてます。GetStatsという関数もあってこっちも使えそうでしたが、なんかうまく動かなかったです。多分Getの方は、Statsの一覧を取得する関数っぽい?
これを呼び出すには、まずどこかのブループリントでイベントディスパッチャー的にデリゲートを呼び出しておいて、
実際にStatsを表示したいタイミングでGet Statsを呼び出します。
今回は、自分のStats Valueを得たいので、Joining PlayerもTarget Playerも自分にしてあります。
今回は、こんな感じで以上です。Achievementは次回かなぁ。。。
0 件のコメント:
コメントを投稿