ScriptSignal

Overview

ScriptSignal은 게임에서 특정 상황이 발생했을 때 이를 감지하여, 해당 신호에 연결된 함수들을 자동으로 실행하는 이벤트 시스템입니다.

신호가 트리거되면 연결된 사용자 정의 함수들이 호출되며, 필요한 경우 이벤트와 관련된 정보를 매개변수로 함께 전달하여 다양한 상호작용을 유연하게 구현할 수 있도록 지원합니다.

Constructors

Properties

Methods

Connect

이벤트 발생 시 호출될 함수를 등록하며, 해당 연결 상태를 관리할 수 있는 ScriptConnection 객체를 반환합니다.

등록된 이후에는 이벤트가 트리거될 때마다 지정된 함수가 자동으로 실행되며, 반환된 연결 객체를 이용해 언제든지 이 이벤트와의 연결을 해제할 수 있습니다.

Parameters

function func	이벤트 신호에 연결할 사용자 정의 함수를 지정합니다.

Return

ScriptConnection	신호 연결을 관리하는 데 사용할 수 있는 ScriptConnection 객체입니다.

Code Samples

local Players = game:GetService("Players")

local function EnterPlayer(player)
    print("EnterPlayer : ", player.Name)
end
Players.PlayerAdded:Connect(EnterPlayer)

Once

이벤트가 발생했을 때 실행될 함수를 단 한 번만 호출되도록 등록하며, 해당 연결 상태를 관리할 수 있는 ScriptConnection 객체를 반환합니다.

Connect와는 달리 첫 번째 이벤트가 전달되기 직전에 연결이 자동으로 해제되므로, 별도의 연결 해제 없이 단일 호출 처리에 적합한 간편한 방식입니다.

Parameters

function func	이벤트 신호에 연결할 사용자 정의 함수를 지정합니다.

Return

ScriptConnection	신호 연결을 관리하는 데 사용할 수 있는 ScriptConnection 객체입니다.

Code Samples

local Players = game:GetService("Players")

local function EnterPlayer(player)
    print("EnterPlayer : ", player.Name)
end
Players.PlayerAdded:Once(EnterPlayer)