composer.removeScene()

类型 函数
composer.*
返回值
修订 版本 2024.3703
关键词 composer, 场景, 删除, removeScene
另请参阅 composer.removeHidden()
composer.getSceneName

概述

此函数用于移除指定的场景(或者选择性地回收它)。 首先会向场景派发一个 destroy 事件。

要回收场景而不是将其完全移除,您可以将 shouldRecycle 参数设置为 true — 这意味着场景的 self.view 显示组将被移除,但其场景对象将保留在内存中。如果您频繁访问该场景,这可以缩短加载时间。如果省略 shouldRecycle 或将其设置为 false(默认值),则将完全移除该场景,包括其场景对象。

语法

composer.removeScene( sceneName [, shouldRecycle] )
sceneName (必填)

字符串. 要回收或移除的场景的名称。例如,如果要回收或移除 scene1.lua,请将 "scene1" 作为此参数传递。

shouldRecycle (可选)

布尔值. 如果应该回收场景而不是完全移除它,请将此参数设置为 true。默认为 false

示例

-- Completely remove the scene, including its scene object
composer.removeScene( "scene1" )
-- Recycle the scene (its view is removed but its scene object remains in memory)
composer.removeScene( "scene1", true )