Device and Network

Keyboard

.showKeyboard

Shows the keyboard for text input.

Parameters

Object object

.updateKeyboard

Update the content of the keyboard input box. It will only take effect when the keyboard is in the pulled-up state.

Parameters

Object object

.hideKeyboard

Hides the active keyboard.

Parameters

Object object

Keyboard events

Listeners for keyboard interactions. Each listener receives a res object.

• onKeyboardInput(listener) / offKeyboardInput(listener): Listen for or remove a listener for keyboard input events.
• onKeyboardHeightChange(listener) / offKeyboardHeightChange(listener): Listen for or remove a listener for keyboard height changes.
• onKeyboardConfirm(listener) / offKeyboardConfirm(listener): Listen for or remove a listener for the Confirm button click.
• onKeyboardComplete(listener) / offKeyboardComplete(listener): Listen for or remove a listener for the keyboard being retracted.

.onKeyboardInput

Listen for keyboard input events

Parameter

res object

.onKeyboardHeightChange

Listen for keyboard height change events.

Parameter

res object

.onKeyboardConfirm

Listen for the event when the user clicks the Confirm button on the keyboard.

Parameter

res object

.onKeyboardComplete

Listen for the event of the keyboard collapse event.

Parameter

res object

.offKeyboardInput

Remove the listener function for keyboard input events.

Example

const

.offKeyboardHeightChange

Remove the listener function for the keyboard height change event.

Example

const

.offKeyboardConfirm

Remove the event listener function when the user clicks the Confirm button on the keyboard.

Example

const

.offKeyboardComplete

Remove the listener function for keyboard input events.

Example

const

Network

.getNetworkType

Reports current network type and basic connection quality indicators.

Parameters

Response object (success callback)

Example

TTMinis.game.getNetworkType({
  success (res) {
    const networkType = res.networkType
    const weakNet = res.weakNet
  }
})

Touch events

APIs for handling touch input. Each listener callback receives a res object containing touches (all current points), changedTouches (points that triggered the event), and a timeStamp.

• onTouchStart(listener) / offTouchStart(listener): Listen for or remove a listener for the start of a touch event.
• onTouchMove(listener) / offTouchMove(listener): Listen for or remove a listener for movement during a touch event.
• onTouchEnd(listener) / offTouchEnd(listener): Listen for or remove a listener for the end of a touch event.
• onTouchCancel(listener) / offTouchCancel(listener): Listen for or remove a listener for when a touch event is interrupted.

A Touch object (touch array) represents a touch point on a touch device. It typically refers to the action of a finger or stylus on a touchscreen device or touchpad.

• number identifier: The Touch object's unique identifier, a read-only property. This identifier remains unchanged throughout the entire movement of a touch action (referring to a finger's touch) on a plane. It can be used to determine whether the tracked action is the same touch event.
• number screenX: The X coordinate of the touch point relative to the left edge of the screen.
• number screenY: The Y coordinate of the touch point relative to the edge of the screen.

.onTouchStart

Listens for the start of a touch interaction.

Parameters

res object

.onTouchMove

Listens for touch movement events.

Parameters

res object

.onTouchEnd

Listens for the end of a touch interaction.

Parameters

res object

.onTouchCancel

Listens for touch interruptions/cancellations.

Parameters

res object

.offTouchStart

Removes a start‑touch listener. The listener function passed to onTouchStart. If this parameter is not passed, all listener functions will be removed.

Example

const listener = function (res) { console.log(res) }

TTMinis.game.onTouchStart(listener)
TTMinis.game.offTouchStart(listener) // You must pass the same function object used for listening.

.offTouchMove

Removes a move‑touch listener. The listener function passed to onTouchMove. If this parameter is not passed, all listener functions will be removed.

Example

const listener = function (res) { console.log(res) }

TTMinis.game.onTouchMove(listener)
TTMinis.game.offTouchMove(listener) // You must pass the same function object used for listening.

.offTouchEnd

Removes an end‑touch listener. The listener function passed to onTouchEnd. If this parameter is not passed, all listener functions will be removed.

Example

const listener = function (res) { console.log(res) }

TTMinis.game.onTouchEnd(listener)
TTMinis.game.offTouchEnd(listener) // You must pass the same function object used for listening.

.offTouchCancel

Removes a cancel‑touch listener. The listener function passed in by onTouchCancel. If this parameter is not passed, all listener functions will be removed.

Example

const listener = function (res) { console.log(res) }

TTMinis.game.onTouchCancel(listener)
TTMinis.game.offTouchCancel(listener) // You must pass the same function object used for listening.