Понятия

Ваша страница работает в заблокированном фрейме внутри приложения Lia и обращается к Lia только через SDK. Три вида, заголовок и меню Lia, а также правила, в рамках которых работает ваша страница.

#Фрейм

Когда кто-то открывает ваше приложение, Lia запрашивает у своего сервера, могут ли они (см. Тест и живой), регистрирует их как игрока вашего приложения, и загружает вашу страницу в фрейме внутри Lia приложения. Ваша страница — это обычная веб-страница: любой фреймворк, любой хостер, обслуживаемый через https.

Фрейм заблокирован, чтобы люди могли доверять каждому приложению в Lia:

• Загружаются только ваши собственные страницы. Фрейм остается в вашем приложении'происхождения (его схема, хост и порт). Ссылка или перенаправление на любой другой сайт блокируется. Откройте другие сайты с помощью Lia.openLink.
• Ваша страница все еще может получать данные. Скрипты, изображения, шрифты и fetch() вызовы к другим адресам работают как на вебе (с CORS, как обычно).
• Нет всплывающих окон или новых окон, нет камеры, микрофона или местоположения, и нет платежей вашего собственного. Деньги, реклама и все на телефоне происходят в Lia'свои экраны поверх вашего приложения.
• Lia слышит только вашу страницу в верхней рамке. SDK вызовы из фрейма на вашей странице или из страницы на другом источнике игнорируются.
• Сообщения маленькие и ритмичные. Вызов более 16,000 символов игнорируется (и таймаут). Более 20 вызовов в одну секунду отклоняются с slow_down.

Lia'фрейм отчитывается LiaApps/1 в конце своего пользовательского агента, если вы хотите распознать его на вашем сервере.

#Мост

Демо SDK взаимодействует с Lia через фрейм'мост. Каждый вызов, который делает ваша страница, - это сообщение с идентификатором; Lia отвечает на него один раз, а SDK превращает это в промис. Lia также отправляет события (тема изменилась, приложение приостановлено), на которые вы слушаете с помощью Lia.on.

Вызовы, которые ждут человека (счет-фактура, реклама, сканер, Face ID, диалог) не имеют ограничения по времени. Все остальные вызовы завершаются неудачей с timeout если Lia не't ответили в течение 20 секунд. За пределами приложения Lia нет моста, и каждый вызов завершается ошибкой с not_in_lia.

#Три вида

Каждое приложение открывается в одном из трех видов, установленных Lia командой для вашего приложения. Ваша страница может переключаться между ними с помощью SDK.

Lia.display говорит, как ваше приложение открылось, и Lia.isFullscreen когда оно'от края до края прямо сейчас. Lia.requestFullscreen() и Lia.exitFullscreen() переключаться между полноэкранным режимом и обычным.

#Lia'заголовка и меню

В sheet и full, Lia рисует заголовок поверх вашей страницы: ваше приложение'иконка и имя (и Тест с вашим именем разработчика во время тестирования), меню ⋯ и Закрыть. Вы можете окрасьте его и покажите кнопка возврата в нем.

Меню ⋯ всегда имеет:

• Настройки, когда ваша страница показывает Lia.settingsButton.
• Вкл./выкл. уведомления, когда ваше приложение может отправлять их (см. Уведомления).
• Выключить или включить звук, которое ваша страница слышит как soundChanged.
• Перезагрузить и Закрыть.

#Пока страница загружается

Lia показывает собственный загрузчик поверх вашего приложения с момента открытия до тех пор, пока ваша страница не вызовет Lia.ready() (или завершает загрузку). Вызовите его, как только ваш первый экран будет нарисован. Если ваша страница не загружается, Lia покажет сообщение с кнопкой «Попробовать снова».

#Пауза и продолжение

Ваша страница слышит pause когда Lia переходит в фоновый режим или покрывает ваше приложение своим экраном (оплата, реклама, диалог, сканер), и resume когда это'возврат. Приостановите таймеры, музыку и циклы игры на pause. См. Цикл жизни и события.

#Одна таблица за раз

Lia показывает одну из своих собственных экранов поверх вашего приложения в одно время. Пока платежная форма, реклама, диалог, выбор друга, запрос уведомлений, сканер или Face ID открыты, другой такой вызов завершается с busy.

#Кто может открыть ваше приложение

• Людям нужен Lia имя пользователя чтобы открыть любое приложение.
• Пока ваше приложение в тест, только вы и ваши тестировщики можете открыть его. Когда он's в режиме реального времени, каждый может. Когда это's приостановлено, никто не может. См. Тест и живой.
• Если команда Lia установила минимальная серия для вашего приложения, людям нужна стREAK проверки, такой длинной, чтобы открыть его. Lia показывает им, как к этому прийти.

Автоматически переведено. Английский — источник истины. Читать на английском