This document is about: VOICE 2

SWITCH TO

VOICE 1 VOICE 2

よくある質問

どのPhoton製品を使用するべきでしょうか？

対象となるゲームやプロジェクトの特性によって異なります。

通常、弊社はFusion または
Quantumの使用を推奨しています。これらは、弊社のもっとも高度なクライアントソリューションです。

概要について、どちらの製品シートにも製品選びのための「Quadrant」が記載されています：

また、Photon CloudとPhoton Serverのどちらを選択すべきかは、こちらを参照ください。

ご不明点はお気軽にお問合せください。

Photon Cloud

Photon Cloudのステータスを確認する方法は?

Photon Cloudのステータスを確認するには、こちらを参照するか、Twitterで@photon_statusをフォローしてください。
最新のステータスについてお知らせします。

デフォルトのPhotonリージョンは？

少なくとも1つのリージョンが利用できる場合、クライアントはPhoton Cloudに接続可能となるべきです。
この点を保証するため、ディベロッパーが明示的に設定しない場合や「ベストリージョン」オプションを選択しない場合には、デフォルト値を設定するか、
またはデフォルト値を使用する必要があります。
デフォルト値はクライアントSDKによって異なります。
ネイティブSDKでは、OpGetRegionsでサーバーによって返されるリージョンリストのインデックス0の値です。
UnityおよびDotNet SDKでは、デフォルトのリージョンは「EU」とする必要があります。

一部のリージョンを無効にすることは可能ですか？

はい。
許可されたリージョンのリストを定義することにより、別の方法で機能します。
詳細は、Dashboardリージョンのフィルタリングを参照してください。

切断後すぐにルームに再び参加する方法は？

ルームへの参加中に発生した予期しない切断から回復するために、クライアントはルームへの再接続と再参加を試みることができます。
これを「クイック再入室」と呼びます。
クイック再入室は、次の場合にのみ成功します：

ルームは同じサーバー上にまだ存在するか、読み込めます：
プレイヤーが退室しても、他のプレイヤーがまだ参加している場合、後者はPhotonサーバー上で生き続けることができます。
プレイヤーが最後に退出し、ルームが空になった場合、EmptyRoomTTLは、プレイヤーが参加または再参加するのを待機している時間です。
EmptyRoomTTLの後、ルームがまだ空で、誰も参加していない場合、Photonサーバーから削除されます。
永続化条件が満たされ、Webhookがセットアップされている場合、ルームの状態を構成済みのWebサービスに保存して、後で読み込むことができます。
アクターは内部でインアクティブとしてマークされます。同じUserIdを持つアクターがアクターのリスト内に存在しますが、現在ルームに参加していません。
これには、PlayerTTLが0と異なる必要があります。
インアクティブなアクターのPlayerTTLが期限切れになりませんでした。アクターが戻ってくるオプションを選択してルームを出ると、インアクティブ化タイムスタンプを保存します。
ルームが稼働している限り、インアクティブ化時間からPlayerTTLミリ秒が経過すると、それぞれのアクターがアクターのリストから削除されます。
それ以外の場合、アクターが再入室を試みるときに、再入室の試行時間とインアクティブ化時間のミリ秒単位の差がPlayerTTLを超えると、アクターはアクターのリストから削除され、再入室は失敗します。
そのため、インアクティブなアクターは、インアクティブ化時間の後、PlayerTTLミリ秒だけルームに再入室できます。

レース状態やその他のマルチスレッドの問題を回避する方法は？

Photonでは、可能な限りシンプルにすることを心がけました：

任意のスレッドからPhotonPeerメソッドを使用できます。
PhotonPeerからのすべての通知は、1つのファイバーで実行されます（ファイバーについては、以下を参照してください）。
ルーム内のすべてのタスクは1つのファイバーで実行されます。
ピアは、マルチスレッドの問題からデータを保護するために、ルームのファイバーにメッセージを送信します。

ファイバーは、FIFO方式で1つずつ順番に実行されるタスクのリストです。
これは、それらが1つのスレッドで実行されることを意味しません。
実際には、多くのスレッドで実行されますが、1つずつ実行されます。
したがって、最初のタスクはスレッドAで実行され、終了すると、2番目のタスクはスレッドBで実行されます。
ただし、特定の瞬間に1つのスレッドだけがルームデータにアクセスします。
多くのファイバーが同じデータにアクセスする場合、ロックを使用します。
たとえば、ルームのキャッシュ内の場合です。

次のようにファイバーを使用できます：

// rooms contructor
someFiber = new PoolFiber(); // create new fiber
someFiber.Start();
someFiber.ScheduleForInterval(someRepetitiveRoutine, 0, 100); // start immediately and repeat every 100 ms, ie 10 times per second. this params may vary as you need
// at some other point, where you need to add more logic to the fiber
someFiber.Enqueue(newTask);
someFiber.Enqueue(()=>{ anotherTask(parameters);});
// from the tasks you can send messages to the room e.g. to notify the room of a result of a task
room.EnqueueMessage(new YourCustomMessage(somethingToSend));

同じコードまたは同じデータを共有する複数のカスタムファイバーを使用する場合、異なるファイバーのアクションが同時に実行されるため、アクセスを同期する必要があることに注意してください。

ログの記録

クライアントが接続または切断する度にログエントリーを書く方法は？

アプリケーションのlog4net.configに以下を追加してください：

XML


<logger name="Photon.SocketServer.ApplicationBase">
	<level value="DEBUG"/>
</logger>

「{MyApplication}.log」からの出力:

正常な接続:

2013-05-02 11:19:02,506 [23] DEBUG Photon.SocketServer.ApplicationBase [(null)] - OnInit - ConnID=17, IP 127.0.0.1 on port 4530
2013-05-02 11:19:02,506 [23] DEBUG Photon.SocketServer.ApplicationBase [(null)] - OnInit - response sent to ConnId 17 with SendResult Ok

切断:

2013-05-02 11:19:07,608 [24] DEBUG Photon.SocketServer.ApplicationBase [(null)] - OnDisconnect - ConnID=17

Photonがクライアントに作業レスポンスを送信する際にログエントリーを書く方法は？

アプリケーションの「log4net.config」に以下を追加してください：

XML


<logger name="Photon.SocketServer.PeerBase">
	<level value="DEBUG"/>
</logger>

「{MyApplication}.log」からの出力:

2013-05-02 11:19:02,569 [21] DEBUG Photon.SocketServer.PeerBase [(null)] - SentOpResponse: ConnID=17, opCode=255, return=0, ChannelId=0 result=Ok size=14 bytes

Photonがクライアントから作業リクエストを受信した際にログエントリーを書く方法は？

この様なログは、アプリケーションのPeerクラス（HivePeerから継承します)でおこなうのが最適です。

XML


<logger name="Photon.Hive.HivePeer">
	<level value="DEBUG"/>
</logger>

「{MyApplication}.log」からの出力:

2013-05-02 11:19:02,553 [21] DEBUG Photon.Hive.HivePeer [(null)] - OnOperationRequest. Code=255

OnOperationRequestメソッドで、ログエントリーの内容を修正可能です。

protected override void OnOperationRequest(OperationRequest operationRequest, SendParameters sendParameters)
{
	if (log.IsDebugEnabled)
    {
		log.DebugFormat("OnOperationRequest. Code={0}", operationRequest.OperationCode);
	}
	// snip
}

クライアントが切断する理由は？タイムアウトのデバッグ方法は？

クライアントが切断する理由を確認するには、ピアでOnDisconnectが呼び出された場合のデバッグログエントリーを書くようにしてください。

XML


<logger name="Photon.Hive.HivePeer">
	<level value="DEBUG"/>
</logger>

ピアクラス(HivePeerから継承します)では、OnDisconnect()メソッドは以下のようになります：

protected override void OnDisconnect(DisconnectReason reasonCode, string reasonDetail)
{
	if (log.IsDebugEnabled)
    {
		log.DebugFormat("OnDisconnect: conId={0}, reason={1}, reasonDetail={2}", this.ConnectionId, reasonCode, reasonDetail);
	}
	// 	
}

「{MyApplication}.log」からの出力:

2013-05-02 11:19:07,639 [12] DEBUG Photon.Hive.HivePeer [(null)] - OnDisconnect: conId=17, reason=ClientDisconnect, reasonDetail=

UDPを使用している場合：「TimeoutDisconnect」の際は、以下のように「reasonDetail」にRoundTripTime履歴が含まれます。

index - sequence - rtt - variance - sentTime - recvTime - cmd_rtt

0 - 326 - 0 - 0 - 830717056 - 830728351 - 11295
1 - 325 - 89 - 19 - 830715918 - 830716042 - 124
2 - 324 - 85 - 14 - 830714826 - 830714904 - 78
3 - 323 - 86 - 17 - 830712751 - 830712813 - 62
4 - 322 - 89 - 14 - 830711659 - 830711737 - 78
5 - 321 - 90 - 16 - 830710551 - 830710645 - 94
6 - 320 - 90 - 19 - 830709428 - 830709537 - 109
7 - 319 - 88 - 19 - 830708320 - 830708414 - 94
8 - 318 - 88 - 23 - 830707197 - 830707306 - 109
9 - 317 - 86 - 24 - 830706105 - 830706183 - 78
10 - 316 - 87 - 29 - 830704701 - 830704763 - 62
... etc ...

各行は以下の値から成ります:

Index -（0から49の範囲の値をとり、0は最新で49は最も古いです。直近の50個のエントリーのみが表示されます。）
Sequence - 増加するシーケンス番号
rtt (RoundTripTime - 最新のRTT、ミリ秒単位 - ACKの処理後、またはタイムアウトの発生後から利用可能です)
variance (最新の偏差、ミリ秒単位)
sentTime (コマンドが送信された時刻)
recvTime (ACKが受信された時刻)
cmd_rtt ( コマンドが送信されてからACKを受信するまでのタイムスパン、ミリ秒単位)

上記の例では、クライアントのcmd_rttは62ミリ秒から124ミリ秒でした。最後のコマンドに対してACKを受信しなかった後、11秒間にわたって切断しました。

Photon Voice

会話をファイルに保存する方法は？

この質問については、2つに分けて回答します：

1.　受信音声ストリーム：

Photon Voiceのストリームは、ペアを使用して一意に識別されます：PlayerIdとVoiceIdです。
このペアによって、リモート音声ストリームのソースを推定できます：どのプレイヤーなのか、またどのレコーダーなのかという点です。
リモートストリーム用に3つのイベントをサブスクライブ可能です：

VoiceConnection.RemoteVoiceAdded(RemoteVoiceLink): 受信した情報とともに、新規でリモート音声ストリームが作成されます。
RemoteVoiceLink.FloatFrameDecoded(float[]): 特定のリモート音声ストリームから、音声フレームが受信されます。
RemoteVoiceLink.RemoteVoiceRemoved: リモート音声ストリームが終了し、破壊されます（転送が停止されます）。

受信リモート音声ストリーム全体を取得したい場合には、以下が可能です：

そのストリーム向けにRemoteVoiceAdded ハンドラー内でファイルを作成し、開きます。
FloatFrameDecoded ハンドラーで音声データのフレームを書き込みます。
RemoteVoiceRemovedハンドラー内でファイルを保存し、閉じます。

ユーザーの入力に応じて、ファイルの開閉やFloatFrameDecodedのアップデートをおこなえます。

2.発信音声ストリーム

発信音声ストリームについては、Voice.LocalVoiceAudio<T>.IProcessorを拡張してカスタムプロセッサを作成することが可能です。
ローカルで録音された音声フレームはIProcessor.Processにあります。
PhotonVoiceCreated Unityメッセージを受信するには、コンポーネントは Recorderと同じGameObjectにひもづける必要があります。
メソッド内で、LocalVoice.AddPreProcessor (転送前) またはLocalVoice.AddPostProcessor（転送後）を使用して、カスタムプロセッサーをローカルの音声処理パイプラインに挿入してください。
サンプルとして「WebRtcAudioDsp.cs」を参照してください。

カスタムの音声ソースを使用する方法は？

独自のカスタム音声ソースで作成された音声をRecorderで転送するには：

1つ目のアプローチ: 消費者がデータストリームを制御

AudioClipWrapperはこのアプローチのサンプルです。
これは、Recorder.AudioClipに割り当てられた音声クリップをストリーミングします。

音声ソースを読み込むクラスを作成し、Photon.Voice.IAudioReaderインターフェースを実装します。例： MyAudioReaderSource
エディタ（またはコード）でRecorder.SourceTypeをFactoryに設定します。

アプリケーションの初期化中に、クラスのインスタンスを任意の場所に作成します(Recorderが作成される前に)：

// MyAudioReaderSource is just an example, replace with your own class name and constructor
recorder.InputFactory = () => new MyAudioReaderSource();

クライアントが音声ルームに接続されRecorderが転送をおこなっている限り、カスタムの音声ソースインスタンス上でIAudioReader.Read(float[] buffer)メソッドが呼び出されます（例　MyAudioReaderSource）。
コールの周波数とバッファサイズは、カスタムの音声ソースインスタンスのIAudioReader.SamplingRateプロパティによって返されるサンプル率に一致するよう調整されます（例　MyAudioReaderSource）。

2つ目のアプローチ: プロデューサーがデータストリームを制御

「AudioUtil.cs」内のToneAudioPusherはこのアプローチのサンプルです。

この場合にはMyAudioPusherSourceなどの代わりにPhoton.Voice.IAudioPusherインターフェースを実装するほうが、より便利です。
任意のコールバックのみを主に格納するIAudioPusher.SetCallbackメソッドを実装する必要があります。
エディタで（またはコードで）Recorder.SourceTypeをFactoryに設定します。
アプリケーションの初期化中に、クラスのインスタンスをどこかに作成します（PhotonVoiceRecorderが作成される前に）：

C#
```
// MyAudioPusherSource is just an example, replace with your own class name and constructor
recorder.InputFactory = () => new MyAudioPusherSource();
```
ストリーミング中に、保有しているサンプルすべてとともに、定期的にIAudioPusher.SetCallbackを使用して（例えばMonoBehaviour.OnAudioFilterReadから）コールバックセットを呼び出します。
Photon Voiceは、バッファリング処理をすべておこないます。

請求

学生、趣味でおこなっているディベロッパー、インディー向けの割引はありますか？

弊社の製品にはすべて、無料プランとワンショットのプランがあります。
また弊社は通常、Unityアセットストアのセールに参加し、また当選者にはクーポンを提供しています。

1つのPhotonアプリケーションに、複数の100CCUプランを組み合わせることはできますか？

いいえ。
The 100 CCUプランは、
AppID１つにつき適用できる100CCUプランは1つです。
有償サブスクリプションと組み合わせ、100CCUプランの期間中全体CCUに加算することは可能です。
自動更新はされません。

1つのアプリに対してより多くのCCUが必要でしたら、その次の段階のプランは500 CCUプランとなります。
月間プランまたは年間プランをご利用中の場合、その月間・年間プランのCCUに加えて100CCU分が追加されます。

QuantumおよびFusionのFree 100CCUプランのみ例外で、Unityアセットストアの100 CCUクーポン（Quantum PlusおよびFusion Plus）と組み合わせることができます。

Photonのプランに付随するトラフィック数はどれくらいですか？また、付随トラフィックの上限を超えたトラフィック数をアプリで生成した場合どうなりますか？

Photon Public CloudおよびPremium CloudプランではＣＣＵごとに3GB含まれています。

たとえば、1,000 CCUの月間プランの場合、月々の付随トラフィック数は3TBとなります。

アプリでこれ以上のトラフィック数が生成されると、当社から自動的にメール通知が送信されます。月末になると、お客様のPhotonアカウントにご登録のメールアドレスに、自動生成された超過請求書が送信されます。請求金額は以下の計算に基づいて決定されています。

合計トラフィック数 - 付随トラフィック数 = 超過トラフィック (単位：GB)

トラフィック料金は、ご使用になるPhoton Cloudリージョンに応じて計算し請求いたします。

ピークCCUがPhoton Cloudプランで予約しているCCUを超過した場合どうなりますか？

ご登録されているプランが、500 CCU / 1,000 CCU / 2,000 CCUプランのいずれかであれば、お客様のアプリケーションに対して「CCUバースト」が自動で有効化されています。お客様のユーザーにできる限り最善の体験をお届けするため、Photon Cloudが予約分以上のCCUも使用を許可します。

バーストが発動すると、ご契約中の利用規約に応じて、48時間以内に必要なCCU数をまかなうサブスクリプションレベルにアップグレードしていただく必要があります。

アップグレードが行われない場合は、Photonアカウントにご登録のメールアドレスにご登録中のプランのCCU数を超過した分について、1CCU単位で計算された超過利用金額をご請求します。

Photonでは「ピークCCU」で請求額を決定しています。これは、当月使用されたリージョンごとのピークCCUの合計です。超過料金請求を防ぐため、ピークの後に使用量が下がったとしても、アップグレードを必ず行ってください。

Photon Cloud

ログの記録

Photon Voice
請求