語法
參數
targetChatControl PartyChatControl*
目標聊天控制項。
chatPermissionOptions PartyChatPermissionOptions
聊天權限選項。
傳回值
PartyErrorc_partyErrorSuccess (如果呼叫成功),否則為錯誤碼。可透過 PartyManager::GetErrorMessage() 擷取錯誤碼的人類可讀形式。
備註
聊天權限可讓您控制任何一對聊天控制項之間的傳入和傳出語音通訊,以及傳入的文字通訊。聊天權限應設定為反映您的目標案例。例如,如果目標聊天控制項是同一隊的成員,您可能會允許雙向音訊。如果目標聊天控制項是敵對隊伍的成員,您可能不會允許任一方向的音訊。無論隊伍為何,您都可能允許接收文字。目標聊天控制項必須是遠端的。預設權限為 PartyChatPermissionOptions::None。
此設定僅限本機。如果本機聊天控制項設定為傳送音訊給遠端聊天控制項,除非遠端聊天控制項也在其程式庫執行個體中設定為接收來自本機聊天控制項的音訊,否則不會傳送任何音訊給遠端聊天控制項。同樣地,如果本機聊天控制項設定為接收來自遠端聊天控制項的音訊,除非遠端聊天控制項也在其程式庫執行個體中設定為傳送音訊給本機聊天控制項,否則不會接收任何來自遠端聊天控制項的音訊。因此,兩個聊天控制項都必須同意允許通訊;一個聊天控制項無法強制另一個接受或傳輸不想要的聊天。
傳送聊天文字沒有相關聯的權限,因為每次呼叫 SendText() 都需要明確的目標聊天控制項清單。包含或省略目標,等同於授與或拒絕該文字訊息的傳送權限。目標仍必須在其程式庫執行個體中設定 PartyChatPermissionOptions::ReceiveText,訊息才會實際傳遞。
Party 程式庫不會強制執行與使用者身分識別相關的平台限制,例如將聊天限制為「僅限好友」的平台設定。設定兩個聊天控制項之間的聊天權限時,應考量平台限制。
