[非公式] Unite Tokyo 2019 Eve2 LT Fes https://connpass.com/event/139403/

1. MagicOnion⼊⾨
2019/9/23
とりすーぷ

2. ⾃⼰紹介
• 「とりすーぷ」
• @toRisouP
• バーチャルキャスト社 開発
• Microsoft MVP
for Developer Technologies 2018〜
VRのアバター

3. 今回の話
• MagicOnionについての概要を説明
• 何のためのフレームワークか
• どんな機能があるのか

4. MagicOnionって何？

5. MagicOnion is 何
• リアルタイムネットワーク通信のフレームワーク
• Photon Serverなどと同列に並ぶもの

6. ⼀般的なサーバ-クライアントの実装
クライアント サーバ

7. ⼀般的なサーバ-クライアントの実装
ここで通信していろいろやりたい
サーバにロジックやデータがある

8. ⼀般的なサーバ-クライアントの実装
ここの通信プロトコルは？
HTTP？ WebSocket？ gRPC ？

9. ⼀般的なサーバ-クライアントの実装
ここの通信プロトコルは？
HTTP？ WebSocket？ gRPC ？
データフォーマットは？
Json？ Xml？Byte[]？

10. ⼀般的なサーバ-クライアントの実装
ここの通信プロトコルは？
HTTP？ WebSocket？ gRPC ？
データフォーマットは？
Json？ Xml？Byte[]？
エンドポイントやAPIスキーマを
どうきめてどう管理するの？

11. ⼀般的なサーバ-クライアントの実装
ここの通信プロトコルは？
HTTP？ WebSocket？ gRPC ？
データフォーマットは？
Json？ Xml？Byte[]？
リアルタイム通信するの？
単発のAPIサーバでいいの？
エンドポイントやAPIスキーマを
どうきめてどう管理するの？

12. ⼀般的なサーバ-クライアントの実装
ここの通信プロトコルは？
HTTP？ WebSocket？ gRPC ？
データフォーマットは？
Json？ Xml？Byte[]？
リアルタイム通信するの？
単発のAPIサーバでいいの？
エンドポイントやAPIスキーマを
どうきめてどう管理するの？
この辺あたりの実装をまとめたものが
MagicOnion

13. MagicOnionって何？
• .NET Core/Unity⽤のリアルタイム通信フレームワーク
• サーバサイドC#、クライアントとコード共有可能
• gRPC + MessagePack
• MITライセンス
• 開発はCySharp社
• メインコミッターはneuecc⽒（UniRxの作者）

14. 要するに？
• サーバサイドのC#ロジックを
クライアントから簡単に実⾏できるフレームワーク
• サーバ側は .NET Core
• クライアント側は Unity / .NET Core

15. MagicOnion
通信プロトコルは「gRPC」
データフォーマットは
「MessagePack」
リアルタイム通信・単発のAPIサーバ
両対応
C#のソースコードがそのまま
エンドポイントやスキーマになる

16. 最⼤の特徴
• 通信レイヤを意識せずにサーバコードを呼び出せる
• サーバとクライアントでC#インタフェースを共有
• async/awaitでメソッド呼び出しするだけでOK
• （ただしgRPCのコネクション管理だけは⾃前で管理が必要）

17. 例
• サーバで⾜し算する
SumAsync(1 , 2);
3
1 + 2

18. 例：サーバサイドで計算する
1.サーバ/クライアントで共有するインタフェースを⽤意
サーバ側/Unity側両⽅に同じファイルを配置する

19. 例：サーバサイドで計算する
2.サーバ側に実装をおく
与えられた値を⾜して返すだけ

20. 例：サーバサイドで計算する
3. Unity側で呼び出す
gRPCのチャンネルを作って

21. 例：サーバサイドで計算する
3. Unity側で呼び出す
ICalculateServiceへのクライアントを作り

22. 例：サーバサイドで計算する
3. Unity側で呼び出す
あとは普通にメソッドコールするだけ
通信の結果はasync/awaitで待つだけでOK

23. 例：サーバサイドで計算する
クライアント
サーバ

24. これだけ！
• 共通のインタフェースを定義して中⾝を実装するだけ
• 通信周りのことはすべてMagicOnionにおまかせ
• アプリケーションレイヤではただ単にメソッドコールするだけでOK
• ただし、事前にコードジェネレート処理だけ必要

25. 必要なもの
• クライアントサイド
• Unity
• MagicOnion
• MessagePack
• gRPC

26. 必要なもの
• サーバサイド
• .NET Core
• MagicOnion
• MessagePack
• Generic Host (追加で⼊れるのをおすすめ)

27. サーバマシンは当然いるよ
• Docker + Kubernetes が推奨
• Google Kubernetes Engineとかそのへんで動かすとよい
• インフラコストはもちろん必要
• k8sの学習コスト
• 動かすお⾦

28. どんな機能があるのか

29. 実装できるAPIの種類
• Service
• UnaryRPC (1Request ‒ 1Response)
• メソッドコールのたびにリクエストを投げる
• StreamingHub
• Duplex Streaming ( N Request ‒ M Response)
• 常時接続
• サーバ/クライアントが任意のタイミングで互いにデータを送れる

30. Service
MagicOnion
Server
Client
• 1回のリクエストで必ず1つのレスポンス

31. StreamingHub
MagicOnion
Server
• 好きなタイミングでリクエストしたり、
サーバからメッセージのブロードキャストが可能
「⾃分のステータス」を定期的に送って
結果を全員へ送る、とか
サーバで計算して

32. フィルタ機能
• 通信の前後に処理を追加できる
• サーバ側
• 「Service」「StreamingHub」両対応
• メソッドを実⾏する前・後両⽅に処理を追加可能
• クライアント側
• 「Service」でのみ利⽤可能
• リクエストを送る直前、レスポンスを受け取った後に処理を追加可能

33. フィルタの⽤途
• 例
• ログ出⼒
• リトライ機構を作る（クライアント側）
• 認証機構を追加する
• 暗号/復号化する
• 実際に通信せずにダミーレスポンスに差し替える（クライアント側）
フィルタは多段に組み合わせて設定してもOK

34. フィルタについて詳しく知りたい
• ぱすたさんの資料がおすすめ
• MagicOnionでの共通処理の挟み⽅
• https://speakerdeck.com/p_a_sta/magiconiondefalsegong-tong-
chu-li-falsexie-mifang

35. まとめ

36. まとめ
• サーバとクライアントをC#で統⼀して作れる！
• クライアントのC#エンジニアがそのままサーバコードをいじれる！
• C#として⾃然な形でサーバロジックが呼び出せて楽しい
• 個⼈開発者はちょっと考えたほうがいいかも
• MagicOnionを動かすサーバ代がどうしても必要（○万円〜/⽉)
• インフラ周りのことを考えなくて済む「Photon Cloud」もアリ

37. 本当はもっと話したかった
• 8分じゃ全然⾜りなかったよ…
• もうちょっと踏み込んだ話は「.NET Conf in Tokyo」で話します
• Room Bは「Unity」トラック
• https://vsuc.connpass.com/event/146588/