本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
實時服務器客戶端 API(C#)參考:異步回調
使用此 C# 即時用戶端 API 參考可協助您準備多人遊戲,以便與部署在 Amazon GameLift 叢集上的即時伺服器搭配使用。如需整合流程的詳細資訊,請參閱 準備您的實時服務器。
遊戲用戶端需要實作這些回呼方法以回應事件。實時服務器調用這些回調以將遊戲相關信息發送到遊戲客戶端。同一事件的回調也可以使用實時服務器腳本中的自定義遊戲邏輯來實現。請參閱 實時服務器的腳本回調。
回呼方法的定義位於 ClientEvents.cs
。
OnOpen()
當伺服器程序接受遊戲用戶端的連線請求時叫用,並開啟連線。
語法
public void OnOpen()
參數
此方法沒有參數。
傳回值
此方法不會傳回任何內容。
OnClose()
當伺服器程序終止與遊戲用戶端的連線時叫用,例如,在遊戲工作階段結束之後。
語法
public void OnClose()
參數
此方法沒有參數。
傳回值
此方法不會傳回任何內容。
OnError()
當即時用戶端 API 請求發生失敗時叫用。您可以自訂此回呼以處理各種連線錯誤。
語法
private void OnError(byte[] args)
參數
此方法沒有參數。
傳回值
此方法不會傳回任何內容。
OnDataReceived()
當遊戲客戶端收到來自實時服務器的消息時調用。這是遊戲用戶端接收到訊息和通知的主要方法。
語法
public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)
參數
- dataReceivedEvent參數
-
訊息活動的相關資訊。
必要:是
傳回值
此方法不會傳回任何內容。
OnGroupMembershipUpdated()
當玩家所屬群組的成員資格更新時叫用。當用戶端呼叫 RequestGroupMembership
時也會叫用此回呼。
語法
public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)
參數
- groupMembershipEvent參數
-
群組成員資格活動的相關資訊。
必要:是
傳回值
此方法不會傳回任何內容。