РуководствоAPI
О платформе

Основные методы

Toast #

toast()

Отображает сообщение на экране. Сообщение не привязано к остальным интерфейсам приложения и существует как отдельный функционал.

Данный метод необходим в большей степени для тестирования

Управление таймерами #

setTimeout()

Создает таймер, который выполнится через заданное количество миллисекунд

setTimeout(() => {
toast("Привет спустя 1 сек!")
}, 1000)

setInterval()

Создает повторяющийся таймер, который будет повторяться через заданное количество миллисекунд. Количество повторений не ограничено, чтобы остановить таймер, используйте clearInterval

const counter = 0
setInterval(() => {
toast(`Привет спустя ${counter++} сек!`)
}, 1000)

clearTimeout(), clearInterval()

Прекращает выполнение таймера

const counter = 0
const intervalId = setInterval(() => {
toast(`Привет спустя ${counter++} сек!`)
}, 1000)

clearInterval(intervalId)


setLoop #

setLoop создает функцию, которая вызывается каждый кадр

Чаще всего это используется в играх для обновления состояния сцены, например:

const speed = 0.1 // Скорость в метрах в секунду
setLoop((deltaTime) => {
const pos = character.position
vec3.scaleAndAdd(pos, pos, character.forward, deltaTime * speed)
character.position = pos
})

setLoop можно также останавливать, как и interval или timeout

const loop = setLoop(...)

clearLoop(loop)

inputKey #

Проверка нажатия конкретной клавиши на клавиатуре, указанной в параметрах функции. Возвращает boolean значение.


const isPress = inputKey(code: string) // true or false

Управление хранилищем #

localstorage.setItem(key: string, data: string)

Сохранение данных в локальное хранилище

localstorage.getItem(key: string)

Получение данных из локального хранилища по ключу. Не забывайте делать JSON.parse(), если данные были сохранены в виде JSON.stringify

localstorage.setItem(‘key’, ‘value’) // Сохранение

const localData = localstorage.getItem(‘key’) // Получение 'value'

Управление пользовательским устройством #

Глобальный объект device содержит основные свойства и методы управления пользовательским устройством

Типы

type TouchEventType = "click" | "touchstart" | "touchmove" | "touchend";

declare class TouchEvent {
type: TouchEventType;
pointerId: number;
clientX: number;
clientY: number;
deltaX: number;
deltaY: number;
defaultPrevented: boolean;
target?: Entity;
preventDefault(): void;
constructor(event: TouchEventType, initValues?: any);
}
Что такое Entity?

Методы и свойства

device: {
platform: "web" | "android" | "ios",
language: string,
addEventListener(channel: TouchEventType, callback: (ev) );
addEventListener(
channel: "resize",
callback: (width: number, height: number)
);
removeEventListener(channel: TouchEventType, callback: (ev));
removeEventListener(
channel: "resize",
callback: (width: number, height: number)
);
}