实时派对 #

实时派对是将团队游戏添加到游戏中的一种好方法，让用户可以组建派对并与派对成员交流。

派对是聚在一起参加某种游戏或社交聚会的一群用户。任何用户均可创建派对，并将担任首任派对长（派对主持人）。用户可以邀请其他玩家加入，也可以将该派对标记为私密，让其他玩家必须请求才能加入。必须一直有一个派对长，当前派对长退出时，需要从当前连接的玩家中选择一个派对长。所有玩家退出后，派对消失。

Nakama 支持的一个非常常见的派对用例是一起匹配到群组中。这适合玩家在团队中协作或玩家在团队战斗中竞争的游戏。可以向匹配程序传递一个派对 ID，该 ID 指示匹配逻辑，确保预留足够的容量来让派对全部加入比赛。

派对与群组功能不同，因为它们不会在用户离线时也在游戏会话之间存续。派对只要还有最后一个用户存在就一直存在。如果您想创建公会系统或其他游戏，这些游戏应作为一个持久实体存在于您的游戏或应用程序中，您应该使用群组。

创建派对 #

任何用户均可创建派对。您可以对派对中允许的最大用户数（最多 256 个）以及成员是否必须等待派对长批准才能加入作出限制。可以创建有状态的派对，派对长可以修改此状态。

Client
1
2
3
4
5
6
7
8
9

// Create an open party (i.e. no approval needed to join) with 10 max users
// This maximum includes the party leader
var party = await socket.CreatePartyAsync(open: true, maxSize: 10);
System.Console.WriteLine("New Party: {0}", party);

// Create a closed party (i.e. approval needed to join) with 5 max users
// This maximum includes the party leader
var party = await socket.CreatePartyAsync(open: false, maxSize: 5);
System.Console.WriteLine("New Party: {0}", party);
Client
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# Create an open party (i.e. no approval needed to join) with 10 max users
# This maximum includes the party leader
var open = true
var max_size = 10
var party = yield(socket.create_party_async(open, max_size), "completed")
print("New party: %s" % party)

# Create a closed party (i.e. approval needed to join) with 5 max users
# This maximum includes the party leader
var open = false
var max_size = 5
var party = yield(socket.create_party_async(open, max_size), "completed")
print("New party: %s" % party)
Client
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

// Create an open party (i.e. no approval needed to join) with 10 max users
// This maximum includes the party leader
const open = true;
const maxSize = 10;
const party = await socket.createParty(open, maxSize);
console.info("New Party: ", party);

// Create a closed party (i.e. approval needed to join) with 5 max users
// This maximum includes the party leader
const open = false;
const maxSize = 5;
const party = await socket.createParty(open, maxSize);
console.info("New Party: ", party);

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

您可以使用运行时代码创建规则，指定哪些用户可以用 before 挂钩在游戏中创建派对。

查找派对 #

创建新派对后，有多种办法与其他用户共享派对 ID，让他们能够查找和加入：

将服务器的这些功能结合起来，为游戏设计提供动力，可以创建奇妙的社交机制，将用户聚集在一起，创建一个有意义的铁杆玩家社区。

Client
1
2
3
4

string partyId = "<partyid>";

// Set a status update with your party ID
await socket.UpdateStatusAsync("Join my party: ", partyId);
Client
1
2
3
4

var party_id = "<party_id>"

# Set a status update with your party ID
var update : NakamaAsyncResult = yield(socket.update_status_async(JSON.print({"Join my party: %s" % party_id}), "completed")
Client
1
2
3
4

const partyId = "<partyId>";

// Set a status update with your party ID
socket.updateStatus("Join my party: ", partyId);

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

有了派对 ID，然后用户就可以加入派对。

加入派对 #

用户只有加入派对后才能发送消息，看到成员列表，或邀请其他用户。

Client
1
2
3
4
5
6
7

string partyId = "<partyid>";
await socket.JoinPartyAsync(partyId);

socket.ReceivedParty += party =>
{
    System.Console.WriteLine("Joined party: " + party);
};
Client
1
2
3
4
5
6

var party_id = "<party_id>"

var join: NakamaAsyncResult = yield(socket.join_party_async(party_id), "completed")

func _on_party_presence(p_presence : NakamaRTAPI.PartyPresenceEvent):
    print("Joined party: %s" % [p_presence.party_id])
Client
1
2
3
4
5
6

const partyId = "<partyId>";
await socket.joinParty(partyId);

socket.onpartypresence = (presence) => {
    console.info("Joined party: ", partyId);
};

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

如派对为私密，用户可以请求加入，派对长可以接受或拒绝。

Client
1
2
3
4
5
6
7
8
9

string partyId = "<partyid>";
// List all existing join requests
var requests = await socket.ListPartyJoinRequestsAsync(partyId);

// Accept a join request
await socket.AcceptPartyMemberAsync(partyId, <userPresence>);

// Reject a join request
await socket.RemovePartyMemberAsync(partyId, <userPresence>);
Client
 1
 2
 3
 4
 5
 6
 7
 8
 9
10

var party_id = "<party_id>"

# List all existing join requests
var requests: NakamaAsyncResult = yield(socket.list_party_join_requests_async(party_id), "completed")

# Accept a join request
var request: NakamaAsyncResult = yield(socket.accept_party_member_async(party_id, <user_presence>), "completed")

# Reject a join request
var request: NakamaAsyncResult = yield(socket.remove_party_member_async(party_id, <user_presence>), "completed")
Client
 1
 2
 3
 4
 5
 6
 7
 8
 9
10

const partyId = "<partyid>";

// List all existing join requests
const requests = await socket.listPartyJoinRequests(partyId);

// Accept a join request
await socket.acceptPartyMember(partyId, <userPresence>);

// Reject a join request
await socket.removePartyMember(partyId, <userPresence>);

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

退出派对 #

用户可随时退出派对如果用户断开连接，且在允许的暂时断开连接超时时间内未重新连接并重新加入该派对，将自动从该派对中删除此用户。 可以将暂时断开连接超时事件配置为服务器的启动选项。

Client
1
2
3

string partyId = "<partyid>";
var party = await socket.LeavePartyAsync(partyId);
System.Console.WriteLine("Left party: " + party);
Client
1
2
3

var party_id = "<party_id>"
var party: NakamaAsyncResult = yield(socket.leave_party_async(party_id), "completed")
print("Left party: %s" % party)
Client
1
2
3

const partyId = "<partyid>";
const party = await socket.leaveParty(partyId);
console.info("Left party: ", partyId);

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

派对长轮换 #

当有用户退出时，服务器将检查他们是否是当前的派对长，如果是，则发送一条消息，指出派对长已经离开，以及哪个成员被提升为新的派对长。

当发生自动提升时，所选的派对长将始终是自创建派对以来参与时间最长的用户。这是一个决定性的过程，无法更改。如果您的游戏需要为提升新派对长设置不同的条件，请参阅人工提升派对长。

发送消息 #

作为派对成员的任何用户都可以向派对发送包含文本、表情或游戏特定动作的消息。

Client
1
2
3
4
5
6
7
8

// Sending a message
socket.SendPartyDataAsync(partyId: "<partyid>", opCode: 1, data: System.Text.Encoding.UTF8.GetBytes("{<message>}"));

// Receiving the message
socket.ReceivedPartyData += data =>
{
    System.Console.WriteLine("Received: " + System.Text.Encoding.UTF8.GetString(data));
};
Client
1
2
3
4
5
6
7
8
9

# Sending the message
var party_id = "<party_id>"
var op_code = 1
var data = "<message>".to_utf8()
var party_message: NakamaAsyncResult =  yield(socket.send_party_data_async(party_id, op_code, data), "completed")

# Receiving the message
var message: NakamaAsyncResult = yield(socket.received_party_data(data), "completed)
print("Received: %s" % message)
Client
 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// Sending the message
const partyId = "<partyId>";
const opCode = 1;
const data = {"hello": "world"};
socket.sendPartyData(partyId, opCode, data);

// Receiving the message
socket.onpartydata = (data) => {
    console.info("Received: ", data)
};

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

人工提升派对长 #

除了常规信息外，派对长还可以发送一条特别提升消息，宣布他们已不再担任现任派对长，以及谁被提升为新派对长。

Client
1
2
3
4
5
6

socket.ReceivedPartyLeader += newLeader =>
{
    System.Console.WriteLine("new party leader " + newLeader);
};

await socket.PromotePartyMemberAsync("<partyid>", partyMember);
Client
1
2
3
4

var new_leader = "<user_id>"
var party_id = "<party_id>"
var leader: NakamaAsyncResult = yield(socket.received_party_leader(party_id, new_leader), "completed)
print("New party leader: %s" % new_leader)
Client
1
2
3
4
5
6

socket.onpartyleader += (newLeader) =>
{
    console.info("New party leader: ", newLeader);
};

await socket.promotePartyMember("<partyid>", partyMember);

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

关闭派对 #

除派对长以外的任何成员均可关闭派对。派对长也可以驱逐所有成员，这将关闭该派对并在服务器上清除其状态。从游戏设计角度看，在大多数情况下，允许派对长退出更有好处。

Client
1
2

string partyId = "<partyid>";
await socket.ClosePartyAsync(partyId);
Client
1
2

var party_id = "<party_id>"
var party: NakamaAsyncResult = yield(socket.close_party_async(party_id), "completed")
Client
1
2

const partyId = "<partyid>";
await socket.closeParty(partyId);

Code snippet for this language C++/Unreal/Cocos2d-x has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Java/Android has not been found. Please choose another language to show equivalent examples.
Code snippet for this language Defold has not been found. Please choose another language to show equivalent examples.
Code snippet for this language REST has not been found. Please choose another language to show equivalent examples.
Code snippet for this language cURL has not been found. Please choose another language to show equivalent examples.

最佳做法 #

我们建议您不要使用派对来实现多人游戏逻辑，也不要将其用于向派对成员发送消息来推动游戏进程的情景。在这些情况，最好在游戏服务器中使用权威多人游戏引擎。这样，您可以完全控制多人游戏网络代码以及与用户行为相关的逻辑。