Skip to content

Commit

Permalink
Add info about collection proxies for zh (#419)
Browse files Browse the repository at this point in the history
* run as admin

* update bob

* update about AndroidX support

* software render

* linux-faq.md update

* 4.28.2021 updates

* Basis Universal format

* sound & mesh

* gamepad event mapping

* admob url

* Minor edit to building blocks intro text

* update gamepad & ios

* project settings

* libffi version

* scaling

* image compression

* update gamepads

* increase memory

* caching assets

* update 2021/10/6

* update 2021/10/16
blend-modes.md

* update 2021/11/12

* allow dynamic transforms update

* Bundle update

* update faq

* bullet & bob

* script properties update

* editor-styling

* build server url

* editor templates

* spine extension update

* Fix typo in the "optimizations" word in Chinese docs

* Update to material.md - Constants buffers

* Verify Graphics Calls

* H5 parameters

* OpenJDK downloads

* cn update corresponds to [pull 259](#259)

* application security

* porting guidelines

* update for 8f1651f

* cn update for 094bf6f

* cn update for 20fdfc5 & 6263317

* cn update for 7/19/2022

* title

* profiling update

* update editor.md

* update bob.md

* update shortcuts

* update fixed update note

* Update properties.md

* Update material.md

* Updates links

* Update bob help with the latest info

* camera & renderer

* Updated android keystore info zh_cn

* bundling.md release vs debug zh_cn

* update bob.md & gui-clipping.md

* contentless bundle

* consoles update

* model animation link

* gamepad & faq

* remove a camera lib

* font shadow render mode fix

* updates about app-manifest and others

* Update script.md

* includes in shaders

* editor scripts

* material updates

* Added dynamic atlas and texture creation

* fixes for atlas and some others

* update screenshots and add explanations (CN)

* add a line about Dynamic Prototype (CN)

* remove "inline" marks in pics

* de-translate the subtitle "Running the debugger" & images fix

* bundle identifier restrictions

* node properties Enabled and Visible (CN)

* release checklist & slice-9

* Update project-settings.md (CN)

* Update camera.md (CN)

* Update project-settings.md (CN)

* culling of meshes (CN)

* Update project-settings.md (CN)

* gltf model file support (CN)

* updates about factory (CN)

* Update bob.md (CN)

* Update bob.jar help (CN)

* Update about renderer and other things

* Update PS4 development and other things

* Dynamic prototype part of the collection factory.

* sync to atlas.md

* sync to design.md

* sync to gpgs.md

* sync to hot-reload.md

* sync to linux.md

* sync to live-update.md

* sync to lua.md

* sync to networking.md

* sync to physics-shapes.md

* sync to push.md

* sync to test.md

* sync to working-offline.md

* update material.md

* update zerobrane.md

* all done

* Splitting .zip archives in live-update.md

* manual for collision events

* Updated sprite documentation to include info about multiple textures

* update editor-scripts.md & physics-events.md

* update buffer.md & physics-shapes.md

* screen blend mode

* Update camera manual for zh with new function.

* Fix texture profile documentation for 1.7.0 zh

* update material.md & render.md

* notice about physics-events

* script-properties notes & PS5

* Clarified collision messages

* Update 3rd party camera list

* Fixed links in live update manual zh

* Update lua.md

* Update html5 manual with new information about CUSTOM_PARAMETERS. zh

* Added note on Apple Privacy Manifests zh

* typo

* Add info about collection proxies for zh

* fix minor mistakes
  • Loading branch information
CocosGames authored Apr 7, 2024
1 parent 8ce72d0 commit 3d46577
Show file tree
Hide file tree
Showing 5 changed files with 20 additions and 13 deletions.
8 changes: 4 additions & 4 deletions docs/zh/manuals/addressing.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ id可以随意设置. 当前我们对游戏对象设置了一个id "bean", sprit

- 首先需要指定目标对象的id ("buddy"),
- 然后是对象/组件分隔符 ("#"),
- 组后是组件的id ("controller").
- 最后是组件的id ("controller").

回过头来看上个例子我们没有指定对象的id, 系统默认对象就是脚本所在的 *当前游戏对象*.

Expand Down Expand Up @@ -155,9 +155,9 @@ Defold 提供两种简化写法用来简化消息传递时需要输入的完整

## 哈希标记

引擎把每个标记都存为哈希值. 所有以组件或游戏对象为参数的方法可以接受字符串, 哈希或者 URL 对象. 我们已经在上面看到如何使用字符串进行定位了.
引擎把每个 id 都存为哈希值. 所有以组件或游戏对象为参数的方法可以接受字符串, 哈希或者 URL 对象. 我们已经在上面看到如何使用字符串进行定位了.

当你获取游戏对象的标记, 引擎总是返回一个绝对路径标记的哈希值:
当你获取游戏对象的 id , 引擎总是返回一个绝对路径 id 的哈希值:

```lua
local my_id = go.get_id()
Expand All @@ -181,7 +181,7 @@ go.set_position(pos, spawned_id)
local other_id = hash("/path/to/the/object")
go.set_position(pos, other_id)

-- This will not work! Relative addresses must be given as strings.
-- 这样无法工作! 相对地址必须使用字符串.
local relative_id = hash("my_object")
go.set_position(pos, relative_id)
```
Expand Down
2 changes: 1 addition & 1 deletion docs/zh/manuals/application-lifecycle.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Defold 应用或者游戏的生命周期相当简单. 引擎切换运行三种

因为 `init()` 代码里可以有消息发布, 工厂创建对象, 删除对象等等操作, 引擎接下来会进入 "post-update" 阶段. 此时消息被发布出去, 工厂实际创建对象, 需要删除的对象进行删除操作. 注意 post-update 阶段包含的 "dispatch messages" 序列不仅发送消息队列还会处理发送给集合代理的消息. 代理子队列 (开启关闭, 载入和标记卸载) 等步骤在此时进行处理.

也就是说在 `init()` 里进行 [集合工厂](/manuals/collection-proxy) 加载操作是完全可行的, 集合初始化, 从代理卸载集合---这些都能在第一个 `update()` 被调用之前进行, 也就是在引擎退出初始化进入更新循环之前进行:
也就是说在 `init()` 里进行 [集合代理](/manuals/collection-proxy) 加载操作是完全可行的, 集合初始化, 从代理卸载集合---这些都能在第一个 `update()` 被调用之前进行, 也就是在引擎退出初始化进入更新循环之前进行:

```lua
function init(self)
Expand Down
2 changes: 1 addition & 1 deletion docs/zh/manuals/atlas.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ Extrude Borders
: 每个图片四周的边缘挤出. 片元着色器采样图片边缘的时候, 相邻图片 (同个图集) 边缘可能会被采集到. 挤出边缘就可以解决这个问题.

Max Page Size
: 多页图集的最大尺寸. 可以用来把一个图集切分成多页来限制图集尺寸以便只用一个 draw call. 它必须与`/builtins/materials/*_paged_atlas.material` 里开启 multi-page atlas enabled materials 一起使用.
: 多页图集的最大尺寸. 可以用来把一个图集切分成多页来限制图集尺寸同时仍然只用一个 draw call. 它必须与`/builtins/materials/*_paged_atlas.material` 里开启 multi-page atlas enabled materials 一起使用.

![Multi-page atlas](images/atlas/multipage_atlas.png)

Expand Down
19 changes: 13 additions & 6 deletions docs/zh/manuals/physics-events.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,17 +9,24 @@ brief: 集中使用 `physics.set_listener()` 进行碰撞监听, 传导碰撞和

## 设置物理世界监听器

要使用这个新方法, 需要使用 `physics.set_listener` 函数. 这个函数的参数是一个回调函数, 物理世界中的所有交互发生时就会调用该函数. 一般语法如下:
Defold 中, 各个集合代理创建各自的物理世界. 所以操作多个集合代理的时候, 保持各个物理世界的独立性很重要. 为确保物理事件在各个物理世界中正确处理, 必须对每个集合代理的世界分别设置监听器.

```lua
physics.set_listener(function(self, event, data)
-- Event handling logic goes here
end)
这钟机制意味着物理事件的侦听器必须在代理集合的上下文中设置. 这样就可以将侦听器直接与相关的物理世界关联起来, 使其能够准确地处理物理事件.

以下是在集合代理里设置物理世界监听器的例子:

```lua
function init(self)
-- 假设此脚本附加到了代理加载集合中的游戏对象里
-- 为此集合代理的物理世界设置物理世界侦听器
physics.set_listener(physics_world_listener)
end
```

通过实现此方法, 就可以确保集合代理生成的每个物理世界都有其专用的侦听器. 这对于使用多个集合代理的项目里能有效处理物理事件很重要.

::: important
如果设置了监听器, [物理消息](/manuals/physics-messages) 就不会再发送了.
如果设置了监听器, [物理消息](/manuals/physics-messages) 就不会再发送给有监听器的物理世界了.
:::

## 事件数据结构
Expand Down
2 changes: 1 addition & 1 deletion docs/zh/shared/components.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

![Components](../shared/images/components.png){srcset="../shared/images/[email protected] 2x"}

许多组件含有某些属性是可以在运行时控制的, 根据组件属性的不同类型, 调用交换的函数也不一样:
许多组件含有某些属性是可以在运行时控制的, 根据组件属性的不同类型, 调用交互的函数也不一样:

```lua
-- 关闭 "body" 精灵
Expand Down

0 comments on commit 3d46577

Please sign in to comment.