发送直接消息 API

您可以使用发送直接消息（dm）api向zepeto世界中的其他用户发送直接消息。 在已启动的世界中使用直接消息（dm）发送api时，消息底部会自动提供一个进入世界的链接，非常适合推广该世界。 使用时请务必遵循注意事项。 安装 窗口 → 包管理器 → zepeto world包，请先安装版本1 21 14或更高版本。 之后，请安装版本为1 0 7或更高的‘zepeto module’包。 确保zepeto应用程序运行版本3 46 000或更高。 发送直接消息api 要使用发送dm api，请添加以下导入语句。 import { socialservice } from 'zepeto module social'; 发送dm核心功能 声明 public static openpopupdirectmessage($sendmessage string, $userids? string\[], $oncomplete? system action$1)\ void; 参数 参数 描述 sendmessage 这是一个必需的参数。这是您要发送的消息的主体。如果它是空白或空的，传输将被视为失败。 userids 这是一个可选参数。 如果您传递 userids \ 选择 ui 将配置相应的用户 id 列表。 当未传递 userids 或传递空列表时 \ 选择 ui 将构建为发送消息的用户的关注/被关注列表。 oncomplete 这是一个回调，当消息发送完成或失败时调用。 直接消息弹出状态 响应 描述 取消 当弹出窗口被手动关闭或发送失败时。 发送完成 当发送请求完成并关闭时。 按错误代码的情况 响应 描述 31002 如果在 userids 参数中输入的用户 id 列表中包含至少一个不正确的 userid（不存在的 userid），则会发生此情况。 37011 当您尝试在访客帐户下发送消息时，会发生此情况。 8001 当您不断重复发送相同的消息时，会发生此情况。每 10 秒可以发送一次。 2001 当“发送”字段中的消息内容为空、仅包含空格或超过 1000 个字符时，会发生此情况。 0 网络连接错误情况，例如网络断开、连接不稳定和其他一般错误情况。 1 无法识别的错误。 使用示例 直接输入发送者并发送 1\) 请将发送 dm 按钮添加到画布中。 2\) 请按照以下示例代码编写。 import { zepetoscriptbehaviour } from 'zepeto script'; import { socialservice, directmessagepopupstate } from 'zepeto module social'; import { button } from "unityengine ui"; import { worldservice } from 'zepeto world'; export default class senddirectmessage extends zepetoscriptbehaviour { // 存储直接消息的变量 public message string; // 要发送直接消息的用户 id 数组 public userids string\[]; // 对按钮 ui 组件的引用 public senddmbutton button; start() { this senddmbutton onclick addlistener(() => { // 检查我的 id 是否包含在 userids 数组中，如果包含则返回 if (this userids includes(worldservice userid)) { console log("userids 包含我的 userid"); return; } // 使用 socialservice 打开发送直接消息的弹出窗口 socialservice openpopupdirectmessage(this message, this userids, (popupstate directmessagepopupstate) => { // 检查直接消息弹出窗口的状态 if (popupstate === directmessagepopupstate cancel) { console log("您关闭了弹出窗口或未能发送消息"); } else if (popupstate === directmessagepopupstate sendcomplete) { console log("dm 消息已成功发送，弹出窗口已关闭。"); } }); }); } } 3\) 编写脚本后，返回 unity 编辑器并将按钮拖到检查器中进行设置。输入消息正文和目标用户的 userid。 最多显示20人，因此请最多输入20人。 4\) 当您按下发送dm按钮时，好友列表ui会出现。 选择目标用户并点击发送。 5\) 如果发送dm成功，将出现一个toast ui，指示成功，并且示例脚本将输出日志。 6\) 此外，目标用户已收到dm。 如果发生错误，例如连续发送消息或消息内容为空，dm传输将被视为失败。 使用以下/关注者列表 ui 发送 1\) 请在画布上添加一个按钮。 2\) 请按照以下示例代码编写。 如果您将空列表传递给 targetuserid 参数，将会出现以下/关注者列表 ui。 import { zepetoscriptbehaviour } from 'zepeto script'; import { socialservice, directmessagepopupstate } from 'zepeto module social'; import { button } from "unityengine ui"; export default class senddirectmessage extends zepetoscriptbehaviour { // 存储直接消息的变量 public message string; // 引用按钮 ui 组件 public senddmbutton button; // 私有变量，用于存储用户 id 数组，初始化为 null private emptyids string\[]; start() { this senddmbutton onclick addlistener(() => { // 打开一个弹出窗口以使用 socialservice 发送直接消息 // 使用类的消息内容和一个空的用户 id 数组 socialservice openpopupdirectmessage(this message, this emptyids, (popupstate directmessagepopupstate) => { // 检查返回的直接消息弹出窗口状态 if (popupstate === directmessagepopupstate cancel) { console log("您关闭了弹出窗口或未能发送消息"); } else if (popupstate === directmessagepopupstate sendcomplete) { console log("直接消息发送成功，弹出窗口已关闭。"); } }); }); } } 3\) 编写脚本后，返回unity编辑器并在检查器中拖动按钮进行设置。然后请输入消息的主体。 4\) 当你按下发送dm按钮时，出现关注/粉丝界面。 选择目标用户并点击发送。（最多可以选择5人） 您一次最多可以向5人发送dm。 您不能向自己发送dm。 实际关注/粉丝用户的数量可能与发送dm弹出窗口中显示的用户数量不同。 这是因为可以选择的用户经过筛选并显示。 如果您选择了一个已阻止接收dm的用户，将视为失败，dm将不会发送。 如果您频繁调用发送dm的api，将受到限制，传输将失败。 您每10秒可以发送一次。请注意不要发送无差别的dm。 如果您发送的消息包含url，将无法正常工作，因此禁止发送包含url的消息。 如果发送的消息为空或空白，将视为失败。请务必写下消息的内容。