Виджеты, плитка и автоматизация

Управление Throne для Android с помощью виджетов главного экрана, уведомления, плитки быстрых настроек, ярлыков и приложений автоматизации, например Tasker.

Виджеты

Виджет Что делает

Переключатель (Toggle) (1×1) Показывает состояние подключения; нажмите, чтобы запустить или остановить его. Если сделать виджет шире, он также показывает имя профиля.

Статус (Status) (4×1) Показывает профиль, его группу и состояние, а во время подключения — скорость через прокси. Нажмите на середину, чтобы запустить или остановить подключение, и на стрелки, чтобы переключиться на предыдущий или следующий профиль.

Виджет	Что делает
`Переключатель` (Toggle) (1×1)	Показывает состояние подключения; нажмите, чтобы запустить или остановить его. Если сделать виджет шире, он также показывает имя профиля.
`Статус` (Status) (4×1)	Показывает профиль, его группу и состояние, а во время подключения — скорость через прокси. Нажмите на середину, чтобы запустить или остановить подключение, и на стрелки, чтобы переключиться на предыдущий или следующий профиль.

Чтобы добавить виджет, нажмите и удерживайте пустое место на главном экране, откройте список виджетов лончера и перетащите Переключатель или Статус на главный экран.

Стрелки перемещаются по группе текущего профиля в порядке списка профилей. Когда Throne подключён, они переключают подключение; когда он остановлен, они только меняют выбранный профиль.

Уведомление

Пока Throne работает, он показывает уведомление с именем профиля и текущей скоростью. Нажмите на него, чтобы открыть Throne. Его параметры находятся в Настройки (Settings) → Внешний вид (Appearance): Показывать название группы в уведомлении (Show group name in notification), Показать прямую скорость (Show direct speed) (по умолчанию включён) и Кнопки уведомлений (Notification buttons).

Можно выбрать до трёх кнопок. По умолчанию это Остановить (Stop), Далее (Next) и Переключить… (Switch…).

Кнопка	Что делает
`Остановить`	Останавливает подключение.
`Назад` (Previous), `Далее`	Переключает на предыдущий или следующий профиль текущей группы, как стрелки виджета `Статус`.
`Переключить…`	Открывает список ваших профилей для переключения.
`Сбросить соединения` (Reset connections)	Закрывает все открытые соединения, чтобы приложения подключились заново.

Если при изменении кнопок Throne подключён, нажмите Применить (Apply), когда Throne покажет «Перезагрузите прокси-сервис, чтобы применить изменения» (Reload proxy service to apply changes). Если уведомления не видно, см. Уведомления.

Плитка быстрых настроек

Чтобы добавить плитку Throne, откройте быстрые настройки, нажмите кнопку редактирования (на большинстве телефонов это значок карандаша) и перетащите плитку к активным плиткам. Нажмите на плитку, чтобы запустить или остановить подключение; если телефон заблокирован, Android сначала попросит его разблокировать. Нажмите на плитку и удерживайте её, чтобы открыть Throne.

Ярлыки

На Android 7.1 и новее нажмите и удерживайте значок Throne, чтобы увидеть ярлыки Переключить (Toggle), Включить (Enable), Выключить (Disable) и Отсканировать QR-код (Scan QR code). Их можно перетащить на главный экран. Ярлыки появляются после первого открытия Throne.

Чтобы поместить на главный экран отдельный профиль (Android 8.0 и новее):

Откройте профиль кнопкой Редактировать (Edit) в его строке, а в раскладке в два столбца и в компактных строках — через ⋮ → Редактировать.
В редакторе профиля нажмите ⋮ → Создать ярлык (Create shortcut) и подтвердите в диалоге лончера.

Ярлык запускает Throne с этим профилем, переключается на него, если запущен другой профиль, или останавливает Throne, если запущен этот профиль.

Автоматизация

Приложения автоматизации, например Tasker или MacroDroid, могут запускать эти активности Throne (пакет com.nb4a.throne). Вводите полное имя класса: сокращённая форма вроде .QuickToggleShortcut не работает.

Класс	Что делает
`io.nekohasekai.sagernet.QuickToggleShortcut`	Запускает выбранный профиль или останавливает подключение, если оно работает.
`io.nekohasekai.sagernet.ui.QuickEnableShortcut`	Запускает выбранный профиль, если Throne остановлен.
`io.nekohasekai.sagernet.ui.QuickDisableShortcut`	Останавливает подключение, если оно работает.
`io.nekohasekai.sagernet.ui.ScannerActivity`	Открывает сканер QR-кодов, а на устройствах без камеры — выбор изображения.

В приложении автоматизации используйте действие, которое запускает активность с помощью интента; оно часто называется «Send Intent» (цель Activity) или «Launch activity». Укажите пакет и класс, а действие (Action) оставьте пустым или укажите android.intent.action.MAIN.

QuickToggleShortcut принимает необязательный extra profile с ID профиля, и тогда работает как ярлык профиля для этого профиля. Extra должен иметь тип long; переданный как целое число (integer) или текст, он игнорируется. Ни один экран приложения не показывает ID профилей, поэтому для одного профиля проще использовать ярлык профиля.

Для проверки с компьютера через adb (--el передаёт extra типа long; замените 12 на ID профиля):

adb shell am start -n com.nb4a.throne/io.nekohasekai.sagernet.ui.QuickEnableShortcut
adb shell am start -a android.intent.action.MAIN -n com.nb4a.throne/io.nekohasekai.sagernet.QuickToggleShortcut --el profile 12

Прежде чем автоматизировать Throne, один раз подключитесь из самого приложения, чтобы Android уже выдал разрешение на VPN.
Если ничего не происходит, приложению автоматизации может понадобиться разрешение на запуск активностей из фона; на многих телефонах это разрешение на показ поверх других приложений.
Чтобы подключаться при включении телефона, используйте вместо этого Автоматическое подключение (Auto connect) или постоянную VPN (Always-on VPN).
Приложения автоматизации также могут открывать ссылки throne://, например чтобы добавить подписку. См. Глубокие ссылки.
Внутренние широковещательные сообщения (broadcasts) Throne, например io.nekohasekai.sagernet.SWITCH_NEXT, защищены разрешением уровня signature, поэтому другие приложения не могут их отправлять.