Starling Spatial Deactivator

AS3 / Starling-空間停電器

這種Starling擴展是解決遊戲對象的2D空間激活 /停用的一種方法。例如，它是為了照顧 /隱藏屏幕外的遊戲元素，不僅……當遊戲對像被認為是活動或不活動的情況下，您基本上都可以用您想做任何您想做的事情。

如果：

• 您的遊戲對象可能會留下定義的活動區域（例如，相機視圖），因此需要停用它們。
• 您的遊戲對象可以相互交互，您需要確保“安全”碰撞遊戲對像被停用。

有關實施的更多詳細信息，請查看演示頁面。

▶現場演示

在這裡嘗試！

如何使用它？

在您的GameManager中：

 private var _deactivator : SpatialDeactivator ;
private var _activeAreaAABB : Rectangle = new Rectangle ( 0 , 0 , 120 , 80 ) ;

public function MyGameManager()
{
	// Create the spatial deactivator
	_deactivator = new SpatialDeactivator(_activeAreaAABB.width * 0.25, _activeAreaAABB.height * 0.25);
	Starling.current.juggler.add(_deactivator);
}

// Called at each frame...
public function update () : void
{
	// Update active area when needed
	_activeAreaAABB.x = ...; // Your complex stuff here
	_activeAreaAABB.y = ...; // Your complex stuff here
	_activeAreaAABB.width = ...; // Your complex stuff here
	_activeAreaAABB.height = ...; // Your complex stuff here

	// IMPORTANT TIP: Update only if AABB has changed!
	_deactivator.updateActiveArea(_activeAreaAABB);
}

public function get deactivator() : SpatialDeactivator
{
	return _deactivator;
}

在您的GameObject中：

 private var _spatialElement : SpatialElement ;

public function MyGameObject(gameManager : MyGameManager)
{
	// Setup game object core components
	_mySprite = ...;
	_myPhysicalBody = ...;

	// IMPORTANT: Make sure that the object starts inactive!
	// The deactivator will take care of activating it right away if needed.
	onSpatialElementActivityChanged(false);

	// Create spatial element
	_spatialElement = new SpatialElement(gameManager.deactivator);
	_spatialElement.activityChangedCallback = onSpatialElementActivityChanged;

	// Initial position update
	updatePosition();
}

// Called during frame update...
public function updatePosition() : void
{
	// Update game object position & size
	x = ...; // Your complex stuff here
	y = ...; // Your complex stuff here
	width = ...; // Your complex stuff here
	height = ...; // Your complex stuff here

	// IMPORTANT TIP: Update only if AABB has changed!
	_spatialElement.updateAABB(x, y, width, height);
}

private function onSpatialElementActivityChanged( active : Boolean ) : void
{
	// Activate / deactivate your object as you want.
	_mySprite.visible = active;
	_myPhysicalBody.enable = active;
	...
}

重要說明：

• 您的遊戲對象必須開始非活動。
• 僅在AABB更改時更新空間元素。

啟用調試模式

調試模式將幫助您查看是否選擇了正確的配置（請參見下面的重要方面）。

您可以像這樣啟用它：

 _deactivator = new SpatialDeactivator( 32 , 32 , true ) ;

if ( _deactivator . debugSprite)
	addChild ( _deactivator . debugSprite) ; 

⌨如何安裝？

只需克隆或下載存儲庫，然後將src/ch文件夾複製/粘貼到您的src目錄中，或將src/文件夾添加到您的類路徑。

重要方面

1。找到右側的大小

使此工具有效的重要一點是找到正確的塊尺寸，以最適合您的需求。

• 太大的塊將涵蓋太多的遊戲對象，因此同時激活了太多的對象。
• 太小的塊將需要很多塊處理。

您可以通過啟用調試模式來測試並查看最適合您的選擇（請參閱部分）。

與活動面積大小相比，我個人使用的比率為0.25 。

 new SpatialDeactivator( _activeAreaAABB . width * 0.25 , _activeAreaAABB . height * 0.25 ) ;

2。找到合適的活動區域大小

如果您的活動區域與相機視圖相對應，則使用餘量對於預測即將到來的遊戲對象的激活可能很有用。

 private var _margin : Number = 20 ;
private var _activeAreaAABB : Rectangle = new Rectangle ( 0 , 0 , 120 + _margin , 80 + _margin ) ;
...
_activeAreaAABB . x = x - _margin * 0.5 ;
_activeAreaAABB . y = y - _margin * 0.5 ;
deactivator . updateActiveArea( _activeAreaAABB ) ;

3。找到正確的空間元素大小

空間元素的大小應涵蓋遊戲對象的整個尺寸，以確保遊戲對像不會過早或過於活躍。如果需要，空間元素的大小也可能比您的遊戲對象的範圍大一點：

 _spatialElement . updateAABB( x - margin * 0.5 , y - margin * 0.5 , width + margin, height + margin) ;