This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
Zaleca się najpierw zapoznać z ogólnym sposobem działania wejścia w Defold, z tym, jak odbiera się wejście i w jakiej kolejności skrypty je otrzymują. Więcej informacji znajdziesz w instrukcji ogólnej o wejściu.
Wyzwalacze myszy pozwalają przypisać wejście z przycisków myszy i kółka przewijania do akcji gry.

Wejścia z przycisków myszy MOUSE_BUTTON_LEFT, MOUSE_BUTTON_RIGHT i MOUSE_BUTTON_MIDDLE są równoważne MOUSE_BUTTON_1, MOUSE_BUTTON_2 i MOUSE_BUTTON_3.
Poniższe przykłady używają akcji pokazanych na obrazku powyżej. Jak w przypadku każdego wejścia, możesz nazwać swoje akcje wejściowe dowolnie.
Przyciski myszy generują zdarzenia pressed (naciśnięcie), released (zwolnienie) i repeated (powtórzenie). Poniższy przykład pokazuje, jak wykryć wejście z lewego przycisku myszy (zarówno przy naciśnięciu, jak i przy zwolnieniu):
function on_input(self, action_id, action)
if action_id == hash("mouse_button_left") then
if action.pressed then
-- lewy przycisk myszy naciśnięty
elseif action.released then
-- lewy przycisk myszy zwolniony
end
end
end
Akcje wejścia MOUSE_BUTTON_LEFT (lub MOUSE_BUTTON_1) są wysyłane także dla pojedynczego dotyku.
action.source odróżnia fizyczne naciśnięcie myszy od kliknięcia symulowanego dotykiem, także przy pierwszym naciśnięciu. Powiąż MOUSE_BUTTON_LEFT z mouse_button_left i użyj tego kodu w skrypcie lub skrypcie GUI:
function init(self)
msg.post(".", "acquire_input_focus")
end
function on_input(self, action_id, action)
if action_id == hash("mouse_button_left") and action.pressed then
if action.source == hash("mouse") then
print("Mouse pressed at:", action.x, action.y)
elseif action.source == hash("touch") then
print("Touch pressed at:", action.x, action.y)
end
end
end
Dotknięcie symulowane jako kliknięcie myszy zgłasza hash("touch") nawet bez osobnego Touch Trigger. Do rozpoznania dotknięcia nie potrzebujesz tabeli action.touch ani wcześniejszego zdarzenia ruchu. Sekcja Źródło urządzenia wejściowego opisuje wszystkie wartości źródła i ich działanie, gdy kilka wiązań współdzieli nazwę akcji.
W systemie iOS własny Info.plist musi włączać UIApplicationSupportsIndirectInputEvents, aby to rozróżnienie działało. Wbudowany manifest już je włącza.
Wejścia z kółka myszy wykrywają przewijanie. Pole action.value ma wartość 1, jeśli kółko zostało przewinięte, i 0 w przeciwnym razie. Zdarzenia przewijania są traktowane jak naciśnięcia przycisków. Obecnie Defold nie obsługuje precyzyjnego przewijania na gładzikach.
function on_input(self, action_id, action)
if action_id == hash("mouse_wheel_up") then
if action.value == 1 then
-- kółko myszy przewinięte w górę
end
end
end
Ruch myszy jest obsługiwany osobno. Zdarzenia ruchu myszy nie są odbierane, jeśli nie skonfigurujesz przynajmniej jednego wyzwalacza myszy.
Ruch wskaźnika nie jest powiązany z nazwą akcji: action_id ma wartość nil, a tabela action zawiera położenie wskaźnika i zmianę położenia. Źródłem jest hash("mouse") dla fizycznej myszy lub hash("touch") dla ruchu symulowanego dotykiem. Próbki akcelerometru również używają action_id == nil, dlatego sprawdzaj źródło, aby je rozróżnić, jak pokazano w sekcji Źródło urządzenia wejściowego.
function on_input(self, action_id, action)
if action_id == nil and
(action.source == hash("mouse") or action.source == hash("touch")) then
-- pozwól obiektowi gry podążać za ruchem myszy/dotyku
local pos = vmath.vector3(action.x, action.y, 0)
go.set_position(pos)
end
end
Wyzwalacze pojedynczego dotyku i wielodotyku są dostępne na urządzeniach iOS i Android w aplikacjach natywnych oraz w pakietach HTML5.

Wyzwalacze pojedynczego dotyku nie są konfigurowane w sekcji Touch Triggers w input bindings. Zamiast tego są automatycznie konfigurowane, gdy masz ustawione wejście myszy dla MOUSE_BUTTON_LEFT lub MOUSE_BUTTON_1.
Wyzwalacze wielodotyku wypełniają tabelę touch w tabeli akcji. Elementy w tabeli są indeksowane liczbami całkowitymi od 1 do N, gdzie N to liczba punktów dotyku. Każdy element zawiera pola z danymi wejściowymi:
function on_input(self, action_id, action)
if action_id == hash("touch_multi") then
-- Twórz obiekt w każdym punkcie dotyku
for i, touchdata in ipairs(action.touch) do
local pos = vmath.vector3(touchdata.x, touchdata.y, 0)
factory.create("#factory", pos)
end
end
end
Multi-touch nie może być przypisany do tej samej akcji co wejście myszy MOUSE_BUTTON_LEFT lub MOUSE_BUTTON_1. Przypisanie tej samej akcji w praktyce nadpisze pojedynczy dotyk i uniemożliwi otrzymywanie jakichkolwiek zdarzeń pojedynczego dotyku.
Biblioteka Defold-Input asset może posłużyć do łatwego ustawienia wirtualnych elementów sterowania na ekranie, takich jak przyciski i analogowe gałki, z obsługą wielodotyku.
Wykrywanie, kiedy użytkownik kliknął lub stuknął element wizualny, to bardzo częsta operacja potrzebna w wielu grach. Może dotyczyć interakcji z przyciskiem lub innym elementem interfejsu użytkownika albo interakcji z obiektem gry, takim jak jednostka kontrolowana przez gracza w grze strategicznej, skarb na poziomie w grze typu dungeon crawler albo zleceniodawca zadania w RPG. Sposób działania zależy od rodzaju elementu wizualnego.
W przypadku elementów UI dostępna jest funkcja gui.pick_node(node, x, y), która zwraca true albo false zależnie od tego, czy podana współrzędna mieści się w granicach węzła GUI. Zobacz dokumentację API, przykład wykrywania wskaźnika lub przykład przycisku aby dowiedzieć się więcej.
W przypadku obiektów gry jest to bardziej złożone, ponieważ takie czynniki jak przesunięcie kamery i projekcja w skrypcie renderowania wpływają na wymagane obliczenia. Istnieją dwa ogólne podejścia do wykrywania interakcji z obiektami gry:
Gotowe rozwiązanie wykorzystujące obiekty kolizji do wykrywania wejścia użytkownika z obsługą przeciągania i kliknięć można znaleźć w Defold-Input asset.
W obu przypadkach trzeba przeliczyć współrzędne ekranu dla zdarzenia myszy lub dotyku na współrzędne świata obiektów gry. Można to zrobić na kilka sposobów: