Навигация

closeSmartApp

iOS 3.3Android 3.3Web 3.3

Метод закрытия SmartApp.

Возвращаемое значение

Возвращаемое значение содержит Promise, который будет исполнен.

Пример:

import * as SDK from "@expressms/smartapp-sdk";

async function test() {
  try {
    await SDK.closeSmartApp());
  } catch(error) {
    console.log(error);
  }
}

routingChanged

iOS 3.0Android 3.0Web 3.0

Метод, вызываемый при навигации по SmartApp. Требуется для корректного закрытия SmartApp.

Аргументы

Параметр	Тип данных	Описание
isRoot	boolean	True, если SmartApp находится в корневом роуте, в ином случае — false

Возвращаемое значение

Возвращаемое значение содержит Promise, который будет исполнен.

Пример:

import * as SDK from "@expressms/smartapp-sdk";

async function handleRoutingChanged(isRoot) {
  try {
    await SDK.routingChanged(isRoot));
  } catch(error) {
    console.log(error);
  }
}

// Обработка событий навигации в применяемом роутере
history.listen(async event => {
  const isRoot = event.pathname === "/";

  await handleRoutingChanged(isRoot);
})

exitSmartAppToCatalog

iOS 3.6Android 3.6Web 3.6

Метод перехода из SmartApp в каталог приложений.

Возвращаемое значение

Возвращаемое значение содержит Promise, который будет исполнен.

Пример:

import * as SDK from "@expressms/smartapp-sdk";

async function test() {
  try {
    await SDK.exitSmartAppToCatalog();
  } catch(error) {
    console.log(error);
  }
}

openClientSettings

iOS 3.1Android 3.1Web 3.1

Метод открытия настроек пользователя.

Возвращаемое значение

Возвращаемое значение содержит Promise, который будет исполнен.

Пример:

import * as SDK from "@expressms/smartapp-sdk";

async function test() {
  try {
    await SDK.openClientSettings();
  } catch(error) {
    console.log(error);
  }
}

openSmartApp

iOS 3.1Android 3.1Web 3.1

Метод открытия другого SmartApp.

Аргументы

Аргументом метода является объект, содержащий параметры:

Параметр	Тип данных	Описание
appId	string	Идентификатор приложения
meta	object	Метаданные, передаваемые в ответе на событие ready (опционально)

Возвращаемое значение

Возвращаемое значение содержит Promise, который будет исполнен.

Пример:

import * as SDK from "@expressms/smartapp-sdk";

async function test() {
  try {
    const appId = "email-app";
    const meta = {
      route: "/send-email",
      email: "test@google.com",
    }

    await SDK.openSmartApp({ appId, meta });
  } catch(error) {
    console.log(error);
  }
}