ویجت‌ها، کاشی و خودکارسازی

ویجت‌ها

ویجت	کارکرد
تغییر وضعیت (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، تنظیمات سریع (Quick Settings) را باز کنید، دکمهٔ ویرایش را بزنید (در بیشتر گوشی‌ها نماد مداد) و کاشی را به میان کاشی‌های فعال خود بکشید. برای شروع یا توقف اتصال روی کاشی بزنید؛ اگر گوشی قفل باشد، Android ابتدا از شما می‌خواهد قفل آن را باز کنید. برای باز کردن Throne، انگشت خود را روی کاشی نگه دارید.

میانبرها

در Android 7.1 و جدیدتر، انگشت خود را روی نماد Throne نگه دارید تا میانبرهای تغییر وضعیت (Toggle)، فعال‌سازی (Enable)، غیرفعال‌سازی (Disable) و اسکن از کد QR (Scan QR code) را ببینید. می‌توانید آن‌ها را به صفحهٔ اصلی بکشید. این میانبرها پس از نخستین باری که Throne را باز می‌کنید ظاهر می‌شوند.

برای قرار دادن یک نمایه روی صفحهٔ اصلی (Android 8.0 و جدیدتر):

1. نمایه را با دکمهٔ ویرایش (Edit) در ردیف آن باز کنید، یا در چیدمان دوستونه و ردیف‌های فشرده با ⋮ ← ویرایش.
2. در ویرایشگر نمایه، روی ⋮ ← ساخت میانبر (Create shortcut) بزنید و در پنجرهٔ لانچر خود تأیید کنید.

میانبر، Throne را با این نمایه اجرا می‌کند، اگر نمایهٔ دیگری در حال اجرا باشد به این نمایه تعویض می‌کند، یا اگر همین نمایه در حال اجرا باشد Throne را متوقف می‌کند.

خودکارسازی

برنامه‌های خودکارسازی مانند Tasker یا MacroDroid می‌توانند این activityهای 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 را باز می‌کند، یا در دستگاه‌های بدون دوربین انتخابگر تصویر را.

در برنامهٔ خودکارسازی، از کنشی (action) استفاده کنید که یک activity را با intent اجرا می‌کند و اغلب «Send Intent» (با مقصد Activity) یا «Launch activity» نام دارد. بسته و کلاس را وارد کنید و Action را خالی بگذارید یا android.intent.action.MAIN را وارد کنید.

QuickToggleShortcut یک extra اختیاری به نام profile با شناسهٔ (ID) یک نمایه می‌پذیرد که آن را مانند یک میانبر نمایه برای همان نمایه به کار می‌اندازد. نوع این extra باید long باشد؛ اگر به‌صورت عدد صحیح (integer) یا متن فرستاده شود، نادیده گرفته می‌شود. هیچ صفحه‌ای از برنامه شناسهٔ نمایه‌ها را نشان نمی‌دهد؛ پس برای یک نمایه، میانبر نمایه ساده‌تر است.

برای تست از رایانه با adb (--el یک extra از نوع long می‌فرستد؛ 12 را با شناسهٔ نمایه جایگزین کنید):

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 را داده باشد.
• اگر اتفاقی نیفتاد، ممکن است برنامهٔ خودکارسازی برای اجرای activityها از پس‌زمینه به مجوز نیاز داشته باشد؛ در بسیاری از گوشی‌ها این همان مجوز نمایش روی برنامه‌های دیگر است.
• برای اتصال هنگام روشن شدن گوشی، به‌جای این کار از اتصال خودکار (Auto connect) یا Always-on VPN (VPN همیشه روشن) استفاده کنید.
• برنامه‌های خودکارسازی می‌توانند لینک‌های throne:// را هم باز کنند؛ برای نمونه برای افزودن یک اشتراک. لینک‌های عمیق را ببینید.
• پیام‌های broadcast داخلی Throne، مانند io.nekohasekai.sagernet.SWITCH_NEXT، با یک مجوز امضا (signature permission) محافظت می‌شوند و برنامه‌های دیگر نمی‌توانند آن‌ها را بفرستند.