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

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

Виджеты

У Throne два виджета для главного экрана:

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

Чтобы добавить виджет:

1. Нажмите и удерживайте пустое место на главном экране.
2. Откройте список виджетов вашего лончера.
3. Найдите Throne и перетащите Toggle или Status на главный экран.

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

Скорость на виджете Status обновляется не чаще чем раз в 3 секунды и только при включённом экране. Если профиль не выбран, виджеты показывают «No profile» (нет профиля) вместо имени профиля.

Уведомление

Пока Throne работает, он показывает уведомление. Нажмите на уведомление, чтобы открыть Throne.

• Заголовок — имя профиля. Если включено Показывать название группы в уведомлении (Show group name in notification), заголовок имеет вид [группа] профиль.
• В тексте показывается текущая скорость. Если включён параметр Показать прямую скорость (Show direct speed), а по умолчанию он включён, показываются две строки: Прокси: …↑ …↓ (Proxy) и Прямой: …↑…↓ (Direct). Если он выключен, показывается только скорость через прокси.
• Мелкий текст показывает объём трафика через прокси с момента подключения.

Эти параметры находятся в Настройки (Settings) → Appearance, в разделе Notification.

Кнопки уведомления

Кнопки выбираются в Настройки (Settings) → Appearance → Notification buttons. Можно выбрать до 3 кнопок. Кнопки по умолчанию — Остановить (Stop), Next и Switch…. Кнопки всегда располагаются в порядке этой таблицы:

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

Previous и Next перемещаются по группе так же, как стрелки виджета Status (см. Виджеты).

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

Если уведомления не видно, возможно, уведомления для Throne заблокированы. См. Уведомления.

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

Плитка Переключатель (Switcher) запускает и останавливает Throne из быстрых настроек. Чтобы добавить её:

1. Проведите вниз от верхнего края экрана, чтобы открыть быстрые настройки.
2. Нажмите кнопку редактирования. На большинстве телефонов это значок карандаша.
3. Перетащите плитку Переключатель к активным плиткам.

Как работает плитка:

• Нажмите на плитку, чтобы запустить или остановить подключение. Если телефон заблокирован, Android сначала попросит его разблокировать.
• Во время подключения на плитке показано имя профиля. В остальное время на ней показано «Throne».
• Нажмите на плитку и удерживайте её, чтобы открыть Throne.

Ярлыки

Ярлыки лончера

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

Ярлык	Что делает
Переключить (Toggle)	Запускает выбранный профиль, если Throne остановлен. Останавливает подключение, если оно работает.
Включить (Enable)	Запускает выбранный профиль, если Throne остановлен.
Выключить (Disable)	Останавливает подключение, если оно работает.
Отсканировать QR-код (Scan QR code)	Открывает сканер QR-кодов. Появляется только на устройствах с камерой.

Ярлыки профилей

На Android 8.0 и новее на главный экран можно поместить ярлык отдельного профиля:

1. Откройте профиль кнопкой Редактировать (Edit) в его строке. Пока профиль запущен, эта кнопка недоступна. В раскладке Два столбца (Double column) используйте ⋮ → Редактировать в строке профиля.
2. В редакторе профиля нажмите ⋮ → Создать ярлык (Create shortcut).
3. Подтвердите в диалоге лончера.

Ярлык называется так же, как профиль. Когда вы нажимаете на него:

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

Создать ярлык доступен только для уже сохранённых профилей.

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

Приложения автоматизации, например Tasker или MacroDroid, могут запускать активности ярлыков Throne. Имя пакета Throne — com.nb4a.throne.

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

Первые три активности ничего не показывают и сразу закрываются. Всегда вводите полное имя класса, как показано. Имена классов не начинаются с имени пакета, поэтому сокращённая форма вроде .QuickToggleShortcut не работает.

QuickToggleShortcut принимает необязательный extra с именем profile, содержащий ID профиля. С этим extra он работает как ярлык профиля для этого профиля: запускает его, переключается на него или останавливает его.

Extra должен иметь тип long (64-битное число). Если приложение автоматизации передаёт его как обычное целое число (integer) или как текст, Throne игнорирует его и переключает подключение так, будто extra нет.

ID профиля — это внутренний номер, который Throne присваивает каждому профилю. Ни один экран приложения его не показывает; он встречается только в некоторых сообщениях, например «Missing server (#…)» (сервер отсутствует). Если вам нужно просто переключаться на один профиль с главного экрана, используйте вместо этого ярлык профиля.

Пример

В приложении автоматизации добавьте действие, которое запускает активность с помощью интента. Оно часто называется «Send Intent» (со значением Activity в поле «Цель») или «Launch activity». Заполните эти поля:

Поле	Значение
Цель (Target)	Activity
Пакет (Package)	com.nb4a.throne
Класс (Class)	io.nekohasekai.sagernet.QuickToggleShortcut
Действие (Action)	android.intent.action.MAIN или оставьте пустым
Extra (необязательно)	Имя profile, тип long, значение: ID профиля

Те же интенты можно отправить с компьютера через adb, например чтобы их проверить:

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

--el передаёт extra типа long. Замените 12 на ID своего профиля.

Советы:

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