Skip to Content
Card SDKНа телефоне

На телефоне

При удалённом доступе телефон показывает весь холст. Свои карточки — единственное исключение из правила «всё работает так же»: телефон никогда не запускает код карточек. У кода сообщества одна песочница — на компьютере, а не вторая, более слабая, в браузере телефона.

Что телефон показывает для своей карточки:

  • шапку — иконку, заголовок, плашку статуса и бейдж, ровно такими, какими их задала ваша карточка;
  • содержимое обзора, которое вы задали через card.setOverview(), — при любом масштабе, а не только при отдалении;
  • строку «Open on the computer to use this card» («Откройте на компьютере, чтобы пользоваться карточкой»).

Пока кто-то смотрит с телефона, продолжает работать всё, что работает на компьютере. Инструменты, которые вызывают агенты, порты, которые доставляют данные, промпты и команды — всё это выполняется на странице карточки на компьютере, пока там открыт её воркспейс (усыплённую карточку, как обычно, разбудят по требованию).

С телефона нельзя устанавливать, обновлять, выдавать разрешения, подключать папки или отвечать на диалоги карточки: при удалённом доступе всё это заблокировано и требует компьютера.

Как это учесть в дизайне

  • Пусть обзор рассказывает главное. primary — один факт (3 failing, Deploy ready, Waiting for review), secondary — подробность, progress — полоса, tone — цвет, icon — из иконок приложения. Обновляйте его всякий раз, как этот факт меняется.
  • Пользуйтесь плашкой статуса и бейджем для того, что должно быть видно с первого взгляда.
  • Вызывайте card.attention('needs-input', …), когда пользователь должен что-то сделать, — карточка пульсирует и попадает во входящие (Inbox).
  • Не полагайтесь на страницу карточки ни в чём срочном: пользователь на телефоне не может её ни увидеть, ни нажать.

В версии 1 запустить страницу вашей карточки на телефоне нельзя.