3.4から4.0へのアップグレードガイド
主な変更点の概要
バージョン3.4から4.0への主な変更は、新しいピアクラスの導入です。
Photon 3では、ピアの2つの異なるクラスがありました:
PeerBase
: Photonクライアントとのすべてのインバウンド接続のベースクラス。ServerPeerBase
: Photonサーバーとのすべての接続のためのベースクラス。
Photon 4では、これらの2つのクラスは適切に置き換える必要があります:
ClientPeer
:PeerBase
を置き換えます。S2SPeerBase
: ServerPeerBase`を置き換える、ベースとなるサーバー間のクラス。InboundS2SPeer
: 受信接続を許容するサーバー上のServerPeerBase
を置き換えます。OutboundS2SPeer
: アクティブに接続を開始するサーバー上のServerPeerBase
を置き換えます。
InboundS2SPeervs
OutboundS2SPeer`
切断やエッジケースにより適切に対応するため、ベースのS2Sクラスは、2つのクラスに分割されます。
Photon Server A --> Photon Server B
Server Aで推奨される方法は
OutboundS2SPeer
を使用することです。
Server Aはアクティブに接続を初期化します。
Photon 3では、発信接続の設定に使用されるメソッドは、ApplicationBase.ConnectXXX
ファミリーのものでした。
これはv4でも可能ですが、新しいOutboundS2SPeer.ConnectXXX
への切り替えをお勧めします。
実際、ApplicationBase.CreateServerPeer
をオーバーライドする必要はありません。
v4でのS2Sコードの詳細については、こちらのアップデートイントロを参照してください。Server Bでは
InboundS2SPeer
を使用するべきです。
Server BはServer Aからのインバウンド接続をリッスンして待ちます。
InoundS2SBase
のコンストラクタがInitResponse
パラメータを持つのはそのためです。
Photon v3 | Photon v4 | ピアのタイプ |
---|---|---|
PeerBase |
ClientPeer |
他のエンドポイント上のクライアントと通信する必要のあるクラスはClientPeer から拡張するべきです。
|
ServerPeerBase |
InboundS2SPeer |
他のPhotonサーバーと受信接続を設定する必要のあるクラスは、InboundS2SPeer から拡張するべきです。
|
ServerPeerBase |
OutboundS2SPeer |
推奨される新しい方法は、別のPhotonサーバーと発信接続を設定する必要のあるクラスを作成する際、OutboundS2SPeer を拡張することです。
|
ServerPeerBase |
S2SPeerBase |
別のPhotonサーバーと発信接続を設定する必要のあるクラスを作成する際のこれまでの方法は、S2SPeerBase を拡張することでした。
|
ライセンスの更新とアップグレード
新しく購入したライセンスファイルを使用して、古いSDKのバージョンを使用する場合や、Photon SDKの新しい主要バージョンにアップグレードする場合は、本番環境に移行するより前に余裕をもって、そのライセンスでPhoton SDKが実行されることを確認してください。
これをおこなう上で最も簡単なのは、該当するライセンスファイルを使用するPhoton SDKフォルダに入れて、Photon Controlアプリケーションを介してPhotonを開始する方法です。
その後、トレイアプリに表示されるライセンス情報を確認し、さらにログを参照してライセンスエラーが無いかを確認します。