AO手册
Begin

创建聊天室

在 aos 中建立一个聊天室

如果您发现自己想学习如何在 ao 中创建聊天室，那么这意味着我们至少了解发送和接收消息的基本方法。如果还没有，建议您在继续之前先查看 Messaging）教程。

在本教程中，我们将使用 Lua 脚本语言在 ao 中构建一个聊天室。 聊天室将具有两个主要功能：

  1. 注册：允许进程加入聊天室。
  2. 广播：从一个进程向所有注册参与者发送消息。

让我们首先为我们的聊天室建立基础。

视频教程

第 1 步：基础

  • 打开您喜欢的代码编辑器。
您可能会发现在代码编辑器中安装推荐扩展 有助于增强您的 Lua 脚本编写体验。
  • 创建一个名为 chatroom.lua 的新文件。

聊天室Lua文件

步骤 2：创建成员列表

  • 在 chatroom.lua 中，您将首先初始化一个列表来跟踪参与者：
    Members = Members or {}

Chatroom Lua 文件 - 命名成员列表

  • 保存 chatroom.lua 文件

步骤 3：将聊天室加载到 aos 中

保存 chatroom.lua 后，您现在将聊天室加载到 aos 中。

  • 如果您尚未启动 aos，请在终端中保存 chatroom.lua 的目录中启动
  • 在 aos CLI 中，键入以下脚本以将您的脚本合并到 aos 进程中：
    .load chatroom.lua

    将聊天室加载到aos
    如上面的屏幕截图所示，您可能会收到 undefined 响应。 这是预期的，但我们仍然希望确保文件正确加载。
    在 aos 的 Lua Eval 环境中，当你执行一段没有显式返回值的代码时，undefined 是标准响应，表示没有返回结果。在加载资源或执行操作时可以观察到这一点。例如，执行 X = 1 将产生 undefined，因为该语句不包含 return 语句。但是，如果执行 X = 1; return X，环境将返回值 1。 在此框架内工作时，理解这种行为至关重要，因为它有助于澄清执行修改状态的命令与旨在产生直接输出的命令之间的区别。
  • 在 aos 中输入 Members 或您为用户列表命名的任何内容。 它应该返回一个空数组 {}。
    查看成员列表
    如果您看到一个空数组，则您的脚本已成功加载到 os 中。

步骤 4：创建聊天室功能

注册处理程序

注册处理程序将允许进程加入聊天室。

  1. 添加注册处理程序: 使用以下代码 修改 chatroom.lua 以包含 Members 的处理程序以注册到聊天室：
    -- 修改 `chatroom.lua` 以包含 `Members` 的处理程序
-- 使用以下代码注册聊天室：

Handlers.add(
  "Register",
  Handlers.utils.hasMatchingTag("Action", "Register"),
  function (msg)
    table.insert(Members, msg.From)
    Handlers.utils.reply("registered")(msg)
  end
)

    注册处理程序
    该处理程序将允许进程通过响应标签 Action = "Register" 来注册到聊天室。注册成功后，将显示一条打印消息确认 registered。
  2. 重新加载并测试： 让我们通过注册到聊天室来重新加载并测试脚本。
    • 使用 .load chatroom.lua 在 aos 中保存并重新加载脚本。
    • 检查注册处理程序是否加载了以下脚本：
    Handlers.list

    检查处理程序列表
    这将返回聊天室中所有处理程序的列表。 由于这很可能是您第一次在 aos 中进行开发，因此您应该只会看到一个名为 Register 的处理程序。
    • 让我们通过注册自己到聊天室来测试注册过程：
    Send({ Target = ao.id, Action = "Register" })

    如果成功，您应该会看到一条 message added to your outbox 信息，然后您会看到一条新的打印消息，上面写着 registered。
    注册聊天室
    • 最后，让我们检查一下是否已成功添加到 Members 列表中：
    Members

    如果成功，您现在将在 Members 列表中看到您的进程 ID。
    查看成员列表

添加广播处理程序

现在您已经有了一个聊天室，让我们创建一个处理程序，允许您向聊天室的所有成员广播消息。

  • 将以下处理程序添加到 chatroom.lua 文件中：
    Handlers.add(
  "Broadcast",
  Handlers.utils.hasMatchingTag("Action", "Broadcast"),
  function (msg)
    for _, recipient in ipairs(Members) do
      ao.send({Target = recipient, Data = msg.Data})
    end
    Handlers.utils.reply("Broadcasted.")(msg)
  end
)

    该处理程序将允许您向聊天室的所有成员广播消息。
  • 让我们通过向聊天室发送消息来测试广播处理程序：
    Send({Target = ao.id, Action = "Broadcast", Data = "Broadcasting My 1st Message" })
    • 如果成功，您应该会看到一条 message added to your outbox，然后您会看到一条新的打印消息，上面写着 Broadcasting My 1st Message，因为您是会员，因此也是此消息的收件人 Members 聊天室的。

步骤 5：邀请 Morpheus 加入聊天室

现在您已成功注册自己到聊天室，让我们邀请 Morpheus 加入我们。 为此，我们将向他发送邀请，允许他注册到聊天室。

Morpheus 是一个自主代理，其处理程序将响应标签 Action = "Join"，然后让他使用您的 Register 标签注册到聊天室。

  • 让我们向 Morpheus 发送加入聊天室的邀请：
    Send({ Target = Morpheus, Action = "Join" })
  • 要确认 Morpheus 已加入聊天室，请检查 Members 列表：
    Members

    如果成功，您将收到来自 Morpheus 的广播消息。

步骤 6：邀请 Trinity 加入聊天室

在此消息中，他将向您提供 Trinity 的进程 ID，并告诉您邀请她加入聊天室。

使用与使用 Morpheus 相同的流程将她的进程 ID 保存为 Trinity 并邀请她加入聊天室。

如果她成功加入聊天室，她就会向你提出下一个挑战，创建一个 代币。

让其他人参与聊天室

引导其他人

  • 邀请 aos 用户： 鼓励其他 aos 用户加入您的聊天室。 他们可以注册并参与广播。
  • 提供入职说明： 与他们共享一个简单的脚本以方便入门：
-- 嘿，我们在aos上聊天吧！ 在您的 aos 环境中发送以下命令来加入我的聊天室：
Send({ Target = [Your Process ID], Action = "Register" })
-- 然后，您可以使用以下方式广播消息：
Send({Target = [Your Process ID], Action = "Broadcast", Data = "Your Message" })

下一步

恭喜！ 您已在 ao 中成功建立了一个聊天室，并邀请了 Morpheus 加入您。您还创建了一个广播处理程序来向聊天室的所有成员发送消息。

接下来，您将继续与 Morpheus 互动，但这次您将在对话中添加 Trinity。她将带领您应对接下来的挑战。 祝你好运！

消息传递

在 ao 中进行消息传递

构建代币

纯手工打造代币

Copyright © 2024