Download to read offline
Uploaded byYutoNishine
Unity + PlayFab + Azure Functions
Unity + PlayFab + Azure Functions C# で統一されたゲーム開発を行う TIPS 2020/4/25 PlayFab Meetup #3 登壇資料
Unity + PlayFab + Azure Functions
- 1. Unity + PlayFab+ Azure Functions C# で統一されたゲーム開発を行う TIPS 南 @_y_minami 2020.04.25 PlayFab Meetup #3
- 2. 自己紹介 • 名前 南（みなみ） • 所属 miraiboxInc. • Twitter @_y_minami • 好き/興味 C# .NET Unity Azure PlayFab MagicOnion 紅茶
- 3.
- 4. 本日の内容 PlayFab の CloudScript と Azure Functions の統合回りのお話。 • Cloud Script とは • Azure Functions とは • PlayFab の Azure Functions 統合の導入方法 • Unity + PlayFab + Azure Functions を便利に使うための TIPS 1. Unity と Azure Functions でコードを共有して楽をしよう 2. Azure Functions でモデルバインディングを使って楽をしよう 3. Azure Functions のコールドスタートを回避しよう • まとめ
- 5. 本日の内容 PlayFab の CloudScript と Azure Functions の統合回りのお話。 • Cloud Script とは • Azure Functions とは • PlayFab の Azure Functions 統合の導入方法 • Unity + PlayFab + Azure Functions を便利に使うための TIPS 1. Unity と Azure Functions でコードを共有して楽をしよう 2. Azure Functions でモデルバインディングを使って楽をしよう 3. Azure Functions のコールドスタートを回避しよう • まとめ Cloud Script を投げ捨てて便利な Azure Functions を使おう。 Azure Functions をもっと便利に使うための TIPS を紹介。
- 6.
- 7. Cloud Script とは •PlayFab の主要な機能の一つ • PlayFab は基本的にはクライアントから API を呼ぶだけで 本来はサーバーが必要なゲームを作れる • しかし PlayFab の機能でまかなうことができない場合もある • その場合は PlayFab 内に自分で書いた Script を登録して それを呼び出して処理することができる • FaaS(Function as a Service) のような感覚で使える • 利用料金は PlayFab の料金に含まれる（つまり無料） • 言語は JavaScript のみに対応 • JavaScript のみに対応…😭
- 8.
- 9. Azure Functions とは（CloudScript との違い） • Azure の主要な機能の一つ • FaaS • いくつかの料金プランがあるが無料から利用可能 • 従量課金プラン（Consumption Plan）は月100万回は無料で実行可能 • 多くの言語に対応 • C# JavaScript F# Java PowerShell Python TypeScript • Visual Studio などでローカルデバッグも可能 • リアルタイムでオンラインのログのモニタリングも可能
- 10. Azure Functions とは（CloudScript との違い） • Azure の主要な機能の一つ • FaaS • いくつかの料金プランがあるが無料から利用可能 • 従量課金プラン（Consumption Plan）は月100万回は無料で実行可能 • 多くの言語に対応 • C# JavaScript F# Java PowerShell Python TypeScript • Visual Studio などでローカルデバッグも可能 • リアルタイムでオンラインのログのモニタリングも可能 Azure Functions は良いところがたくさん。 特にクライアント/サーバーを C# で統一できることが最高。 Cloud Script は投げ捨てて Azure Functions を使っていこう。 （まだプレビューだけど）
- 11. PlayFab + AzureFunctions の導入方法
- 12. PlayFab + AzureFunctions の導入方法 時間がないのでスキップ！ 公式ドキュメントか、以下のブログがわかりやすくておすすめ。 PlayFab アカウントだけでなく Azure アカウントが必要なので そちらの取得も忘れずに。 • ねこじょーかーさん 【PlayFab】Azure関数でCloudScriptを実行する方法 https://playfab-master.com/playfab-azure-cloudscript • Simplestarさん Unity オンラインゲームに Microsoft Azure Functions C# と PlayFab はいかが？ https://qiita.com/simplestar/items/ea909e37b82731a91ffe
- 13. Unity + PlayFab+ Azure Functions を 便利に使うための TIPS
- 14. Unity と AzureFunctions で コードを共有して楽をしよう
- 15. Unity と AzureFunctions で コードを共有して楽をしよう Unity と Azure Functions はどちらも C# で書ける。 それならコードを共有しない手はない。 やり方はいくつかあるが自分が好きな方法を紹介。 最初の環境構築手順がやや複雑だがとても便利。
- 16. 完成系のプロジェクト構成 - Assembly-Csharp - PlayFab -PlayFabEditorExtensions - PlayFabSDKEditor この4つは Unity 側のプロジェクト。 - YourTitle.AF これは Azure Functions のプロジェクト。 - YourTitle.Shared これは Unity と AF 両方で使うクラスライ ブラリ。実態は Unity 側にある。
- 17.
- 18.
- 19. Unity のプロジェクトを作る Azure Functionsのプロジェクトと区別しやすくするために プロジェクト名に .Unity とかつけるのが好き。 Unity が起動したら PlayFab Editor Extension で PlayFab SDK も入れる。
- 20. Azure Functions のプロジェクトを追加 ソリューションを右クリックして追加。 VisualStudio は必須ではない。 VS Code でも大丈夫。 他の IDE でも多分大丈夫。
- 21. Azure Functions のプロジェクトを追加 AzureFunctions を選択。 見つからないときは検索。
- 22. Azure Functions のプロジェクトを追加 プロジェクト名に.AF とかつけるのが好き。 お好みで。
- 23. Azure Functions のプロジェクトを追加 Httptrigger を選択。 Authorization level は Functions か Anonymous に。
- 24. 現在の状態 ここまでは Unity +PlayFab + Azure Functions を使う場合の基本的な作業。 ここからコード共有の作業。
- 25. コード共有するフォルダとスクリプトを Unity 側で用意 /Assets/Scripts にShared フォルダを作る。 共有したいコードはここに保存する。 今回はサンプルとして Character クラスのスクリプトを保存した。
- 26.
- 27.
- 28.
- 29.
- 30. クラスライブラリを作成 YourTitle.Shared をダブルクリックして .csprojを編集。 Compile Include に Unity で用意した Shared フォルダのパスを指定。
- 31. クラスライブラリを作成 編集した .csproj を保存するとCharacter.cs が見えるようになる。
- 32. Azure Functions のプロジェクトから クラスライブラリを参照する YourTitle.AFを右クリックして 参照を追加。
- 33. Azure Functions のプロジェクトから クラスライブラリを参照する YourTitle.Sharedを選択して OK。 これでコード共有の設定は完了。 Unity の /Assets/Scripts/Shared に保存した コードは AF のプロジェクトから使える。 めでたし！
- 34.
- 35. Docs の AzureFunctions のサンプルコード
- 36. Docs の AzureFunctions のサンプルコード パラメータを HttpRequest で受け取って 中身の string(json)を FunctionExecutionContext<dynamic> にデシリアライズして FunctionArgument を dynamic のままごにょごにょしてdynamic で返している つらそうなコード…(´・ω・｀)
- 37.
- 38. モデルバインディングを使ったコード FunctionExecutionContext<T> で受け取って素直に使う。 HttpRequest やJson や dynamic がなくなってシンプル。 dynamic を使わないから型の恩恵を受けられる。 型はいいぞ！
- 39.
- 40.
- 41. Unity 側のサンプルコード(After) Docs のサンプルコードではDictionary だけど任意の型で OK。
- 42.
- 43. コールドスタート is 何？ •Azure Functions の従量課金プランで発生する事象。 • ある程度の期間(20分?) Azure Functions を実行しなかった場合、 その次の呼び出しの応答は通常より時間がかかる。(10秒程度)
- 44. コールドスタート is 何？ •Azure Functions の従量課金プランで発生する事象。 • ある程度の期間(20分?) Azure Functions を実行しなかった場合、 その次の呼び出しの応答は通常より時間がかかる。(10秒程度) PlayFab から Azure Functions を呼んだときのタイムアウトは10秒。 開発中タイトルやユーザーが極端に少ないタイトルでは タイムアウトエラーによるが発生してしまう。
- 45. コールドスタートへの向き合い方 • Azure Functionを Premium か App Service Plan で使う → コールドスタートさせないオプションが使える。正攻法。 → そこそこのお金がかかる。 • タイムアウトのリトライ処理を書いて我慢する → エラーは抑制できても10秒以上待たせるユーザー体験は NG。 • Function を定期的に実行してコールドさせない → 実は Azure Functions の Timer Trigger を使えば簡単。
- 46. コールドスタートへの向き合い方 • Azure Functionを Premium か App Service Plan で使う → コールドスタートさせないオプションが使える。正攻法。 → そこそこのお金がかかる。 • タイムアウトのリトライ処理を書いて我慢する → エラーは抑制できても10秒以上待たせるユーザー体験は NG。 • Function を定期的に実行してコールドさせない → 実は Azure Functions の Timer Trigger を使えば簡単。 ↑ 採用
- 47. Timer Trigger のAzure Function を追加 Azure Functions のプロジェクトを右 クリックして追加。
- 48. Timer Trigger のAzure Function を追加 名前を Timer.cs にして追加。 名前はお好みで OK。
- 49. Timer Trigger のAzure Function を追加 Timer trigger を選択して OK。 Schedule はデフォルトで5分毎 なのでそのままで大丈夫。
- 50. Timer Trigger のAzure Function を追加 Timer Trigger の Function が追加された。 これをデプロイすると Azure Functions はコールドスタートしなくなる。 お手軽！
- 51.