消息通信

Cocos Creator 3D 内,所有的交互都是通过 消息系统

而消息也需要在 "contributions" 里定义后才能使用。

查看已有功能的公开消息

编辑器在顶部菜单 "开发者" - "消息列表" 里,预置了一个消息管理面板,面板里可以显示每个功能定义的公开消息及其说明。

定义一条消息

{
    "name": "hello-world",
    "contributions": {
        "messages": {
            // name 是消息的名称
            "name": {
                "public": false,
                "description": "",
                "doc": "",
                "methods": []
            }
        }
    }
}

public

类型 {string} 可选

是否对外显示这条消息,如果为 true,则会在消息列表界面显示这条消息的基本信息。

description

类型 {string} 可选

如果 public 为 true,则会在消息列表显示一些简单的描述,支持 i18n:key 语法

doc

类型 {string} 可选

如果 public 为 true,则会显示这条消息的一些文档,支持 i18n:key 语法。

这个文档使用 markdown 格式撰写并渲染。

methods

类型 {string[]} 可选

消息触发的方法队列。

这是一个字符串数组,字符串为扩展或者面板上的方法(methods)。 如果是扩展上的方法,则直接定义 "methodName",如果要触发扩展里定义的面板上的方法,则要填写 "panelName.methodName"。例如场景管理器的 ready 方法,就是 scene:ready

定义广播消息

开发一个扩展的时候,完成一个动作后需要向其他功能发送一些通知,这些通知也需要显示在 "消息列表" 面板上的话,可以这样定义消息:

{
    "name": "hello-world",
    "contributions": {
        "messages": {
            "hello-world:ready": {
                "public": true,
                "description": "hello-world 插件准备就绪通知"
            }
        }
    }
}

results matching ""

    No results matching ""