App Methods

Methods for interacting with the host SuperApp — user info, device features, navigation, and lifecycle.

getInfo

Retrieves the current user's profile information.

JavaScript

gametegra.getInfo()

Unity

var result = await gametegra.getUserInfo();

Godot

var result = await gametegra.getUserInfo()

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "name": "player1",
    "surname": "",
    "email": "player1@example.com",
    "age": 28
  },
  "errorMessage": null
}

---

getLanguage

Returns the app language and the device's system language.

JavaScript

gametegra.getLanguage()

Unity

var result = await gametegra.getLanguage();

Godot

var result = await gametegra.getLanguage()

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "appLanguage": "en",
    "deviceLanguage": "tr-TR"
  },
  "errorMessage": null
}

---

getLocation

Gets the device's current GPS location.

JavaScript

gametegra.getLocation()

Unity

var result = await gametegra.getLocation();

Godot

var result = await gametegra.getLocation()

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "latitude": 41.0082,
    "longitude": 28.9784,
    "accuracy": 10
  },
  "errorMessage": null
}

---

camera

Opens the device camera and returns a base64-encoded JPEG image.

JavaScript

gametegra.camera()

Unity

var result = await gametegra.openCamera();

Godot

var result = await gametegra.openCamera()

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAASABIAAD/..."
  },
  "errorMessage": null
}

---

getImage

Opens the device photo gallery for image selection.

JavaScript

gametegra.getImage()

Unity

var result = await gametegra.openGallery();

Godot

var result = await gametegra.openGallery()

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": false,
  "data": {
    "error": "Do not give consent"
  },
  "errorMessage": null
}

---

pay

Initiates a payment transaction for the given amount.

JavaScript

gametegra.pay(100)

Unity

var result = await gametegra.pay(100);

Godot

var result = await gametegra.pay(100)

Parameters:

Name	Type	Required	Description
amount	number	Yes	Amount to charge in the app's currency unit.

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": false,
  "data": {
    "error": "Do not give consent"
  },
  "errorMessage": null
}

---

getParams

Retrieves a launch parameter passed to the miniapp by key.

JavaScript

gametegra.getParams('gameId')

Unity

var result = await gametegra.getParams();

Godot

var result = await gametegra.getParams()

Parameters:

Name	Type	Required	Description
key	string	Yes	The parameter key to look up.

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": false,
  "data": {
    "error": "Parameter not found"
  },
  "errorMessage": null
}

---

openMiniApp

Opens another miniapp by its ID and returns the new session ID.

JavaScript

gametegra.openMiniApp('2037673912111730688')

Unity

await gametegra.openMiniApp("2037673912111730688");

Godot

var result = await gametegra.openMiniApp('2037673912111730688')

Parameters:

Name	Type	Required	Description
miniAppId	string	Yes	The target miniapp's unique identifier.

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "sessionId": "1774982421631322"
  },
  "errorMessage": null
}

---

searchMiniapps

Searches available miniapps by a text query.

JavaScript

gametegra.searchMiniapps('tavla')

Unity

var result = await gametegra.searchMiniapps("tavla");

Godot

var result = await gametegra.searchMiniApps('tavla')

Parameters:

Name	Type	Required	Description
query	string	Yes	Search term. Use at least 4 characters to avoid native errors.

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "results": [
      {
        "id": "1966424934443913216",
        "name": "tavla",
        "score": 1
      },
      {
        "id": "2025032671452729344",
        "name": "Tavla",
        "description": "Tavla oyunu",
        "logo_url": "http://developer.supergamefy.com/api/MiniApp/2025032671452729344/logo.png",
        "category_names": [
          "Strategy"
        ],
        "score": 0.6666667
      }
    ]
  },
  "errorMessage": null
}

---

reportEvent

Reports a custom analytics event with arbitrary data.

JavaScript

gametegra.reportEvent({ eventType: 'level_complete', data: { level: 5, score: 1200 } })

Unity

await gametegra.reportEvent("level_complete", new Dictionary<string,object>{ {"level",5},{"score",1200} });

Godot

var result = await gametegra.reportEvent('level_complete', { 'level': 5, 'score': 1200 })

Parameters:

Name	Type	Required	Description
eventType	string	Yes	The event type identifier (e.g. 'level_complete').
data	object	No	Arbitrary key-value data attached to the event.

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "status": "ok"
  },
  "errorMessage": null
}

---

reportMiniApp

Submits a report or feedback about a user or the miniapp itself.

JavaScript

gametegra.reportMiniApp({ type: 'report', message: 'Cheating', meta: { target_type: 'user', target_user_id: 'user_abc' } })

Unity

await gametegra.reportMiniApp("report", "Cheating", new Dictionary<string,object>{ {"target_type","user"},{"target_user_id","user_abc"} });

Godot

var result = await gametegra.reportMiniApp({ 'type': 'report', 'message': 'Cheating', 'meta': { 'target_type': 'user', 'target_user_id': 'user_abc' } })

Parameters:

Name	Type	Required	Description
type	`string ('report'	'feedback')`	Yes
message	string	Yes	Description of the report.
meta	object	No	Optional metadata. Fields: target_type ('user'

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": true,
  "data": {
    "status": "ok"
  },
  "errorMessage": null
}

---

callMethod

Calls a custom method exposed by the host app by name.

gametegra.callMethod('getInventory', { userId: '123' })

Parameters:

Name	Type	Required	Description
name	string	Yes	The custom method name registered on the host.
params	object	No	Parameters to pass to the method.

Response:

{
  "onClientSuccess": true,
  "onHostSuccess": false,
  "data": {
    "error": "Do not give consent for custom Method"
  },
  "errorMessage": null
}

---

startStream

Starts listening to a named event stream. Returns an Emitter to subscribe/unsubscribe.

gametegra.startStream('game-events', { filter: 'all' })

Parameters:

Name	Type	Required	Description
streamName	string	Yes	The name of the stream to subscribe to.
options	object	No	Optional stream options (e.g. { filter: 'all' }).

Response:

{
  "id": "5371c3c4-8a87-40e8-b13c-4e875d46dd6e",
  "stream": "game-events",
  "_ended": false
}

---

showLoading

Displays the host app's loading spinner.

JavaScript

gametegra.showLoading()

Unity

gametegra.showLoading();

Godot

gametegra.showLoading()

---

hideLoading

Hides the host app's loading spinner.

JavaScript

gametegra.hideLoading()

Unity

gametegra.hideLoading();

Godot

gametegra.hideLoading()

---

vibrate

Triggers a haptic vibration on the device.

JavaScript

gametegra.vibrate()

Unity

gametegra.vibrate();

Godot

gametegra.vibrate()

---

getSafeAreaInsets

Returns the device's safe area insets (notch, home bar, etc.).

JavaScript

gametegra.getSafeAreaInsets()

Unity

var insets = gametegra.getSafeAreaInsets();

Godot

var insets = gametegra.getSafeAreaInsets()

Response:

{
  "top": 47,
  "bottom": 34,
  "left": 0,
  "right": 0
}

---

close

Completely closes and unmounts the miniapp.

gametegra.close()

---

sendToBackground

Minimizes the miniapp and sends it to the background without closing it.

gametegra.sendToBackground()

---

showMenu

Displays the miniapp's native menu overlay.

gametegra.showMenu()

---

setOrientation

Sets the screen orientation mode.

gametegra.setOrientation({ mode: 'landscape' })

Parameters:

Name	Type	Required	Description
mode	`string ('portrait'	'landscape'	'auto')`

---

onBackground

Registers a callback that fires when the miniapp is sent to the background.

JavaScript

gametegra.onBackground(() => { pauseGame() })

Unity

gametegra.onBackground(() => PauseGame());

Godot

gametegra.onBackground(func(): pauseGame())

Parameters:

Name	Type	Required	Description
callback	function	Yes	Function to call when the app goes to background.

Response:

"function(){ i.delete(e) }"

---

onForeground

Registers a callback that fires when the miniapp returns to the foreground.

JavaScript

gametegra.onForeground(() => { resumeGame() })

Unity

gametegra.onForeground(() => ResumeGame());

Godot

gametegra.onForeground(func(): resumeGame())

Parameters:

Name	Type	Required	Description
callback	function	Yes	Function to call when the app returns to foreground.

Response:

"function(){ i.delete(e) }"

---