Differences

This shows you the differences between two versions of the page.

--- zh_cn:tutorial:networking [2022/01/28 07:10] – [The concept of tracking and why you only see the highlighted block] solidblock
+++ zh_cn:tutorial:networking [2024/07/05 10:58] (current) – solidblock
@@ Line 1: / Line 1: @@
 **注意：**本页已经取代旧版页面。建议使用本页描述的新的网络API。旧的页面参见[[tutorial:legacy:networking-v0|此处（英文）]]。
+对于 1.20.5 引入的新的网络通信 API，请参见 [[#1.20.5 中的网络通信]]。
 ====== 网络通信 ======
@@ Line 41: / Line 43: @@
 要修复崩溃，你需要了解 Minecraft 如何在客户端和专用服务器之间通信（communication）。
-[[Minecraft 的逻辑段|{{tutorial:sides.png?700}}]]
+[[Minecraft 的逻辑端|{{tutorial:sides.png?700}}]]
 从上面这张图可以看到，游戏客户端和专用服务器是相互分离的系统，并使用数据包（packets，注意不是 datapack）桥接在一起。这个数据包桥（packet bridge）不仅存在于游戏客户端和专用服务器之间，还存在于您的客户端和通过 LAN 连接的另一个客户端之间。注意即使是单人游戏也有数据包桥，这是因为游戏客户端会启动一个特殊的集成服务器实例来运行游戏。下表显示了三种连接类型之间的主要区别：
@@ Line 72: / Line 74: @@
 </code>
-接下来，我们需要将数据包发送到游戏客户端。首先需要定义一个用于识别数据包的 ''Identifier''。对于本例，我们的标识符为 ''wiki_example:highlight_block''。为将数据包发送到游戏客户端，需要指定要哪个玩家的游戏客户端接收数据包。由于该操作发生在逻辑服务器上，所以可以将 ''player'' 向上强转为 ''ServerPlayerEntity''。
+接下来，我们需要将数据包发送到游戏客户端。首先需要定义一个用于识别数据包的 ''Identifier''。对于本例，我们的标识符为 ''tutorial:highlight_block''。为将数据包发送到游戏客户端，需要指定要哪个玩家的游戏客户端接收数据包。由于该操作发生在逻辑服务器上，所以可以将 ''player'' 向上强转为 ''ServerPlayerEntity''。
+<code java>
+public class TutorialNetworkingConstants {
+    // 存储数据包的 id 以便后面引用
+    public static final Identifier HIGHLIGHT_PACKET_ID = Identifier.of("tutorial", "highlight_block");
+}
+</code>
 要将数据包发送到玩家，我们使用 ''ServerPlayerNetworking'' 中的一些方法。我们使用该类中的以下方法：
@@ Line 81: / Line 89: @@
 </code>
-数据包将会被发送到此方法中的玩家。通道名称是你之前决定用来识别数据包的 ''Identifier''。''PacketByteBuf'' 用于存储数据包的数据。We will return later to writing data to the packet's payload via the buf.
+数据包将会被发送到此方法中的玩家。通道名称是你之前决定用来识别数据包的 ''Identifier''。''PacketByteBuf'' 用于存储数据包的数据。然后我们返回，以通过 buf 将数据写入数据包的有效负载。
 由于我们没有向数据包写入任何数据，所以现在，我们将发送带有空有效负载的数据包。可以使用 ''PacketByteBufs.empty()'' 创建带有空有效负载的 buf。
@@ Line 159: / Line 167: @@
 首先，将数据包发送到服务器是通过 ''ClientPlayNetworking.send'' 完成的。在服务器接收数据包与在客户端接收数据包比较类似，使用 ''ServerPlayNetworking.registerGlobalReceiver(Identifier channelName, ChannelHandler channelHandler)'' 方法。用于服务器网络通信的 ''ChannelHandler'' 也会通过 ''player''参数传入发送该数据包的 ''ServerPlayerEntity''（玩家）。
-===== 跟踪的概念以及为什么你只看到高亮的方块 =====
+===== 追踪的概念以及为什么只有你看到高亮的方块 =====
 现在，高亮魔杖恰当地使用了网络，因此专用服务器不会崩溃。你邀请你的朋友回到服务器上来炫耀高亮魔杖，你使用魔杖，并且该方块也在你的客户端上高亮了，并且服务器没有崩溃。但是，你的朋友没有看到高亮。这是你在此处已有的代码有意为之的。为解决此问题，看一下物品的 ''use'' 代码：
 <code java [enable_line_numbers="true"]>
     public TypedActionResult<ItemStack> use(World world, PlayerEntity user, Hand hand) {
-        // Verify we are processing the use action on the logical server
+        // 确认我们是否是在逻辑服务器上进行操作
         if (world.isClient()) return super.use(world, user, hand);
-        // Raycast and find the block the user is facing at
+        // 视线追踪并找到玩家朝向的方块
         BlockPos target = ...
         PacketByteBuf buf = PacketByteBufs.create();
@@ Line 184: / Line 191: @@
 <code java [enable_line_numbers="true", highlight_lines_extra="10,11,12,13"]>
     public TypedActionResult<ItemStack> use(World world, PlayerEntity user, Hand hand) {
-        // Verify we are processing the use action on the logical server
+        // 确认我们是否是在逻辑服务器上进行操作
         if (world.isClient()) return super.use(world, user, hand);
-        // Raycast and find the block the user is facing at
+        // 视线追踪并找到玩家朝向的方块
         BlockPos target = ...
         PacketByteBuf buf = PacketByteBufs.create();
         buf.writeBlockPos(target);
-        // Iterate over all players tracking a position in the world and send the packet to each player
+        // 迭代世界上所有追踪位置的玩家，并将数据包发送给每个玩家
         for (ServerPlayerEntity player : PlayerLookup.tracking((ServerWorld) world, target)) {
             ServerPlayNetworking.send(player, TutorialNetworkingConstants.HIGHLIGHT_PACKET_ID, buf);
@@ Line 202: / Line 209: @@
 这样修改之后，当你使用魔杖时，你的朋友也应该在他们自己的客户端上看到高亮方块。
-====== Advanced Networking topics ======
-The Networking system Fabric API supplies is very flexible and supports additional features other than just sending and receiving simple packets. As some of these more advanced topics are long, here are links to their specific pages:
+===== 1.20.5 中的网络通信 =====
+自 1.20.5 开始，网络通信的逻辑被大改。在 1.20.5 中，''RegistryByteBuf'' 现在用于游玩阶段网络，你需要定义一个 ''Payload''。首先，定义一个包含了 ''BlockPos'' 的 ''Payload''：
-^ Networking Topic ^ Description ^
+<code java>
-| [[tutorial:networking:connection_events|Connection Network connection events]] | Events related to the the lifecycle of a connection to a client or server |
+public record BlockHighlightPayload(BlockPos blockPos) implements CustomPayload {
-| [[tutorial:networking:channel_events|Channel registration events]] | Events related to a server of client declaring the ability to receive a packet on a channel of a specific name |
+  public static final Id<BlockHighlightPayload> ID = new CustomPayload.Id<>(TutorialNetworkingConstants.HIGHLIGHT_PACKET_ID);
-| [[tutorial:networking:login|Login phase networking]]| Sending requests to a client during login; and allowing delay of login for a short amount of time |
+  public static final PacketCodec<PacketByteBuf, BlockHighlightPayload> CODEC = PacketCodec.tuple(BlockPos.PACKET_CODEC, BlockHighlightPayload::blockPos, BlockHighlightPayload::new);
-| [[tutorial:networking:dynamic_handlers|Dynamic registration of channel handlers]]| Allowing for a connection to receive a packet with a special handler |
+  // 或者，你也可以这样写：
+  // public static final PacketCodec<PacketByteBuf, BlockHighlightPayload> CODEC = PacketCodec.of((value, buf) -> buf.writeBlockPos(value.blockPos), buf -> new BlockHighlightPayload(buf.readBlockPos()));
+  @Override
+  public Id<? extends CustomPayload> getId() {
+    return ID;
+  }
+}
+</code>
+然后，像这样注册 receiver：
+<code java>
+PayloadTypeRegistry.playS2C().register(BlockHighlightPayload.ID, BlockHighlightPayload.CODEC);
+ClientPlayNetworking.registerGlobalReceiver(BlockHighlightPayload.ID, (payload, context) -> {
+  context.client().execute(() -> {
+    ClientBlockHighlighting.highlightBlock(client, target);
+  });
+});
+</code>
+现在，在服务器一端，你可以像这样把数据包发送给玩家：
+<code java>
+    public TypedActionResult<ItemStack> use(World world, PlayerEntity user, Hand hand) {
+        if (world.isClient()) return super.use(world, user, hand);
+        // ...
+        for (ServerPlayerEntity player : PlayerLookup.tracking((ServerWorld) world, target)) {
+            ServerPlayNetworking.send(player, new BlockHighlightPayload(blockPos));
+        }
+        return TypedActionResult.success(user.getHandStack(hand));
+    }
+</code>