Detecteer gebruikersinvoer | Documentatie

Het verbinden van gebruikersinvoer met acties geeft gebruikers veel betere en intuïtieve controle over de functies van je spel. In deze tutorial koppel je een herlaadactie aan een specifieke toets.

Aan de slag

Deze tutorial maakt gebruik van de Blaster tool die is gemaakt in Create Player Tools. Je kunt die instructies volgen om de tool te maken of je kunt het Blaster model downloaden en in StarterPack invoegen.

Modellen kunnen aan je Inventaris worden toegevoegd om tussen verschillende spellen te worden gebruikt. Om een model aan je spel toe te voegen:

Open in een browser de model pagina en klik op de Krijg knop. Dit voegt het model aan je inventaris toe.
Open vanuit het Venster menu of de Start tabbalk de Toolbox en selecteer de Inventaris tab.
Zorg ervoor dat de dropdown op Mijn Modellen staat.
Selecteer het Blaster model om het aan het spel toe te voegen.

Maak een actiehandler

Eerst heb je een functie nodig om te handelen wanneer gebruikersinvoer wordt gedetecteerd.

Open de ToolController LocalScript binnen de Blaster.

Maak een variabele om een naam voor de actie op te slaan.

local tool = script.Parent

local RELOAD_ACTION = "reloadWeapon"

local function toolEquipped()
	tool.Handle.Equip:Play()
end

local function toolActivated()
	tool.Handle.Activate:Play()
end

tool.Equipped:Connect(toolEquipped)
tool.Activated:Connect(toolActivated)

Maak een functie genaamd onAction die drie argumenten ontvangt: actionName, inputState en inputObject. Dit zal de functie zijn die wordt uitgevoerd wanneer gebruikersinvoer wordt gedetecteerd.

local tool = script.Parent

local RELOAD_ACTION = "reloadWeapon"

local function onAction(actionName, inputState, inputObject)

end

local function toolEquipped()
	tool.Handle.Equip:Play()
end

Controleer binnen de functie of de gegeven actionName overeenkomt met de naam van de herlaadactie en zorg ervoor dat inputState gelijk is aan UserInputState.Begin (de beginstatus). Dit is belangrijk omdat de functie elke keer wordt uitgevoerd wanneer de inputState verandert, maar de herlaadactie slechts één keer hoeft te gebeuren.
local function onAction(actionName, inputState, inputObject) if actionName == RELOAD_ACTION and inputState == Enum.UserInputState.Begin then end end

Om het voor de gebruiker duidelijk te maken wanneer deze herlaadt, verander je de TextureId van de tool tijdelijk naar "rbxassetid://6593020923" en verander je het daarna terug naar de oorspronkelijke waarde van "rbxassetid://92628145".

local function onAction(actionName, inputState, inputObject)
	if actionName == RELOAD_ACTION and inputState == Enum.UserInputState.Begin then
		tool.TextureId = "rbxassetid://6593020923"
		task.wait(2)
		tool.TextureId = "rbxassetid://92628145"
	end
end

Koppel de actie

ContextActionService kan worden gebruikt om een functie te koppelen aan een specifieke invoer door gebruik te maken van de BindAction functie, die verschillende argumenten accepteert:

De naam van de actie.
De functie om de actie te verwerken (ook wel een "callback" genoemd).
Of er een touchscreenknop moet worden weergegeven.
Een aantal Enum.KeyCodes om te detecteren en te associëren met de actie.

KeyCodes zijn waarden die verschillende invoertoetsen vertegenwoordigen, zoals toetsen op het toetsenbord of knoppen op een controller. Een volledige lijst van codes is beschikbaar hier.

Verkrijg ContextActionService aan het begin van het script.

local ContextActionService = game:GetService("ContextActionService")

local tool = script.Parent

local RELOAD_ACTION = "reloadWeapon"

Roep binnen de toolEquipped functie BindAction aan en geef de volgende argumenten door:

De naam van de actie (RELOAD_ACTION)
De actiehandler (onAction)
Een waarde om een aanraakknop te maken (true)
Een toetsdruk om te detecteren (Enum.KeyCode.R)

local RELOAD_ACTION = "reloadWeapon"

local function onAction(actionName, inputState, inputObject)
	if actionName == RELOAD_ACTION and inputState == Enum.UserInputState.Begin then
		tool.TextureId = "rbxassetid://6593020923"
		task.wait(2)
		tool.TextureId = "rbxassetid://92628145"
	end
end

local function toolEquipped()
	ContextActionService:BindAction(RELOAD_ACTION, onAction, true, Enum.KeyCode.R)
	tool.Handle.Equip:Play()
end

Test het spel door de tool uit te rusten en op de R toets op je toetsenbord te drukken. Het rugzakpictogram zou tijdelijk moeten veranderen in een wacht symbool om aan te geven dat het wapen aan het herladen is:

Ontkoppel de actie

Wanneer de gebruiker de tool uittrekt, moet de actie worden ontkoppeld zodat ze niet kunnen herladen zonder dat de tool is uitgerust.

Maak een nieuwe functie genaamd toolUnequipped en roep UnbindAction aan, waarbij je de actienaam doorgeeft.

local function toolEquipped()
	ContextActionService:BindAction(RELOAD_ACTION, onAction, true, Enum.KeyCode.R)
	tool.Handle.Equip:Play()
end

local function toolUnequipped()
	ContextActionService:UnbindAction(RELOAD_ACTION)
end

local function toolActivated()
	tool.Handle.Activate:Play()
end

tool.Equipped:Connect(toolEquipped)
tool.Activated:Connect(toolActivated)

Verbind de toolUnequipped functie met de Unequipped gebeurtenis zodat de functie wordt uitgevoerd wanneer de gebeurtenis wordt geactiveerd.

local ContextActionService = game:GetService("ContextActionService")

local tool = script.Parent

local RELOAD_ACTION = "reloadWeapon"

local function onAction(actionName, inputState, inputObject)
	if actionName == RELOAD_ACTION and inputState == Enum.UserInputState.Begin then
		tool.TextureId = "rbxassetid://6593020923"
		task.wait(2)
		tool.TextureId = "rbxassetid://92628145"
	end
end

local function toolEquipped()
	ContextActionService:BindAction(RELOAD_ACTION, onAction, true, Enum.KeyCode.R)
	tool.Handle.Equip:Play()
end

local function toolUnequipped()
	ContextActionService:UnbindAction(RELOAD_ACTION)
end

local function toolActivated()
	tool.Handle.Activate:Play()
end

tool.Equipped:Connect(toolEquipped)
tool.Unequipped:Connect(toolUnequipped)
tool.Activated:Connect(toolActivated)

Test het spel om te bevestigen dat alles correct werkt. Je zou moeten kunnen herladen wanneer de tool is uitgerust, maar niet wanneer deze is uitgetrokken.

Je herlaadanimatie is nu compleet - voor een extra uitdaging, probeer een munitieteller te tellen elke keer dat de blaster wordt afgevuurd. Je kunt dan de toolActivated functie deactiveren wanneer het wapen geen munitie meer heeft, en deze opnieuw activeren zodra de herlaadanimatie is voltooid.