ویجتها، کاشی و خودکارسازی
Throne برای Android را از ویجتهای صفحهٔ اصلی، اعلان، کاشی تنظیمات سریع، میانبرهای لانچر و برنامههای خودکارسازی مانند Tasker کنترل کنید.
میتوانید بدون باز کردن برنامه، Throne را اجرا یا متوقف کنید و بین نمایهها جابهجا شوید. این صفحه ویجتهای صفحهٔ اصلی، اعلان، کاشی تنظیمات سریع (Quick Settings)، میانبرهای لانچر و برنامههای خودکارسازی مانند Tasker یا MacroDroid را پوشش میدهد.
ویجتها
Throne دو ویجت صفحهٔ اصلی دارد:
| ویجت | اندازهٔ پیشفرض | چه چیزی نشان میدهد | چه کاری میتوانید انجام دهید |
|---|---|---|---|
Toggle |
1×1 | وضعیت اتصال. اگر ویجت را پهنتر کنید، نام نمایه را هم نشان میدهد. | برای شروع یا توقف اتصال روی آن بزنید. |
Status |
4×1 | نام نمایه، گروه آن و وضعیت. در حالت متصل، سرعت آپلود و دانلود پروکسی بهجای وضعیت نمایش داده میشود. | برای شروع یا توقف اتصال روی وسط آن بزنید. برای رفتن به نمایهٔ قبلی یا بعدی روی پیکانها بزنید. |
برای افزودن ویجت:
- انگشت خود را روی یک ناحیهٔ خالی از صفحهٔ اصلی نگه دارید.
- فهرست ویجتهای لانچر خود را باز کنید.
- Throne را پیدا کنید و
ToggleیاStatusرا به صفحهٔ اصلی بکشید.
پیکانهای ویجت Status به ترتیب فهرست نمایهها، در گروهِ نمایهٔ فعلی جابهجا میشوند. پس از آخرین نمایه، دوباره از اولی شروع میکنند. اگر گروه فقط یک نمایه داشته باشد، پیکانها پنهان میشوند. وقتی Throne متصل است، پیکان اتصال را به نمایهٔ دیگر منتقل میکند. وقتی Throne متوقف است، پیکان فقط نمایهٔ انتخابشده را تغییر میدهد.
سرعت روی ویجت Status حداکثر هر 3 ثانیه یک بار، و فقط وقتی صفحه روشن است، بهروز میشود. اگر هیچ نمایهای انتخاب نشده باشد، ویجتها بهجای نام نمایه «No profile» (بدون نمایه) را نشان میدهند.
اعلان
تا وقتی Throne در حال اجراست، یک اعلان نشان میدهد. برای باز کردن Throne روی اعلان بزنید.
- عنوان، نام نمایه است. اگر
نمایش نام گروه در نوار اعلان(Show group name in notification) روشن باشد، عنوان به شکل[group] profileاست، یعنی نام گروه در کروشه و پس از آن نام نمایه. - متن اعلان سرعت فعلی را نشان میدهد. اگر
نمایش سرعت(Show direct speed) روشن باشد (پیشفرض)، دو خط نشان میدهد:سرعت: …↑ …↓ومستقیم: …↑ …↓(در برنامهٔ انگلیسیProxy: …↑ …↓وDirect: …↑ …↓). اگر خاموش باشد، فقط سرعت پروکسی را نشان میدهد. - متن کوچک، ترافیک پروکسی از زمان شروع اتصال را نشان میدهد.
این گزینهها در تنظیمات (Settings) ← Appearance، در بخش Notification (اعلان) قرار دارند.
دکمههای اعلان
دکمهها را در تنظیمات ← Appearance → Notification buttons انتخاب کنید. حداکثر 3 دکمه میتوانید انتخاب کنید. دکمههای پیشفرض توقف (Stop)، Next و Switch… هستند. دکمهها همیشه به ترتیب این جدول نمایش داده میشوند:
| دکمه | کارکرد |
|---|---|
توقف (Stop) |
اتصال را متوقف میکند. |
Previous |
به نمایهٔ قبلی در گروه فعلی میرود. |
Next |
به نمایهٔ بعدی در گروه فعلی میرود. |
Switch… |
فهرستی از نمایههای شما را باز میکند. یکی را انتخاب کنید تا به آن تعویض شود. |
بازنشانی اتصالات (Reset connections) |
همهٔ اتصالهای باز را میبندد تا برنامهها دوباره وصل شوند. |
Previous و Next به همان شیوهٔ پیکانهای ویجت Status در گروه جابهجا میشوند (ویجتها را ببینید).
اگر هنگام تغییر دکمهها Throne متصل باشد، وقتی پیام «برای اعمال تغییرات، سرویس پراکسی را دوباره راهاندازی کنید» نمایش داده شد روی اعمال تغییرات (Apply) بزنید.
اگر اعلان را نمیبینید، ممکن است اعلانها برای Throne مسدود شده باشند. اعلانها را ببینید.
کاشی تنظیمات سریع
کاشی سوییچر (Switcher) از تنظیمات سریع (Quick Settings)، Throne را اجرا یا متوقف میکند. برای افزودن آن:
- از بالای صفحه به پایین بکشید تا تنظیمات سریع باز شود.
- دکمهٔ ویرایش را بزنید. در بیشتر گوشیها این دکمه نماد مداد است.
- کاشی
سوییچررا به میان کاشیهای فعال خود بکشید.
کاشی اینگونه کار میکند:
- برای شروع یا توقف اتصال روی کاشی بزنید. اگر گوشی قفل باشد، Android ابتدا از شما میخواهد قفل آن را باز کنید.
- در حالت متصل، کاشی نام نمایه را نشان میدهد. در غیر این صورت «Throne» را نشان میدهد.
- برای باز کردن Throne، انگشت خود را روی کاشی نگه دارید.
میانبرها
میانبرهای لانچر
در Android 7.1 و بعد از آن، انگشت خود را روی نماد Throne نگه دارید تا این میانبرها را ببینید. میتوانید هر میانبر را به صفحهٔ اصلی بکشید. این میانبرها پس از نخستین باری که Throne را باز میکنید ظاهر میشوند.
| میانبر | کارکرد |
|---|---|
تغییر وضعیت (Toggle) |
اگر Throne متوقف باشد، نمایهٔ انتخابشده را اجرا میکند. اگر اتصال برقرار باشد، آن را متوقف میکند. |
فعالسازی (Enable) |
اگر Throne متوقف باشد، نمایهٔ انتخابشده را اجرا میکند. |
غیرفعالسازی (Disable) |
اگر اتصال برقرار باشد، آن را متوقف میکند. |
اسکن از کد QR (Scan QR code) |
اسکنر کد QR را باز میکند. فقط در دستگاههای دارای دوربین نمایش داده میشود. |
میانبرهای نمایه
در Android 8.0 و بعد از آن، میتوانید میانبری برای یک نمایه روی صفحهٔ اصلی قرار دهید:
- نمایه را با دکمهٔ
ویرایش(Edit) در ردیف آن باز کنید. این دکمه تا وقتی نمایه در حال اجراست غیرفعال است. در چیدماندوستونه(Double column)، از ⋮ ←ویرایشدر همان ردیف استفاده کنید. - در ویرایشگر نمایه، روی ⋮ ←
ساخت میانبر(Create shortcut) بزنید. - در پنجرهٔ لانچر خود تأیید کنید.
میانبر نام نمایه را دارد. وقتی روی آن میزنید:
- اگر Throne متوقف باشد، با این نمایه اجرا میشود.
- اگر نمایهٔ دیگری در حال اجرا باشد، Throne به این نمایه تعویض میشود.
- اگر همین نمایه در حال اجرا باشد، Throne متوقف میشود.
ساخت میانبر فقط برای نمایههایی در دسترس است که از قبل ذخیره شدهاند.
خودکارسازی
برنامههای خودکارسازی مانند Tasker یا MacroDroid میتوانند activityهای میانبر 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 را باز میکند. در دستگاههای بدون دوربین، بهجای آن انتخابگر تصویر را باز میکند. |
سه activity اول چیزی نشان نمیدهند و بلافاصله بسته میشوند. همیشه نام کامل کلاس را همانطور که نشان داده شده وارد کنید. نام کلاسها با نام بسته شروع نمیشوند، بنابراین شکل کوتاهی مانند .QuickToggleShortcut کار نمیکند.
QuickToggleShortcut یک extra اختیاری به نام profile با شناسهٔ (ID) یک نمایه میپذیرد. با این extra، مانند یک میانبر نمایه برای آن نمایه عمل میکند: آن را اجرا میکند، به آن تعویض میشود یا آن را متوقف میکند.
نوع این extra باید long (عدد 64 بیتی) باشد. اگر برنامهٔ خودکارسازی شما آن را بهصورت عدد صحیح معمولی (integer) یا متن بفرستد، Throne آن را نادیده میگیرد و وضعیت اتصال را طوری تغییر میدهد که گویی extra وجود ندارد.
شناسهٔ نمایه عددی است که Throne بهطور داخلی به هر نمایه میدهد. هیچ صفحهای از برنامه آن را نشان نمیدهد؛ فقط در چند پیام ظاهر میشود، مانند «Missing server (#…)» (سرور موجود نیست). اگر فقط میخواهید از صفحهٔ اصلی به یک نمایه تعویض کنید، بهجای این کار از میانبر نمایه استفاده کنید.
مثال
در برنامهٔ خودکارسازی خود، کنشی (action) را اضافه کنید که یک activity را با intent اجرا میکند. این کنش اغلب «Send Intent» (با مقصد Activity) یا «Launch activity» نام دارد. این فیلدها را پر کنید:
| فیلد | مقدار |
|---|---|
| Target (مقصد) | Activity |
| Package (بسته) | com.nb4a.throne |
| Class (کلاس) | io.nekohasekai.sagernet.QuickToggleShortcut |
| Action (کنش) | android.intent.action.MAIN، یا آن را خالی بگذارید |
| Extra (اختیاری) | نام profile، نوع long، مقدار: شناسهٔ نمایه |
میتوانید همین intentها را از رایانه با 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 را با شناسهٔ نمایهٔ خود جایگزین کنید.
نکتهها:
- پیش از خودکارسازی، یک بار از داخل برنامهٔ Throne متصل شوید تا Android از قبل مجوز VPN را داده باشد.
- اگر اتفاقی نیفتاد، راهنمای برنامهٔ خودکارسازی خود را دربارهٔ اجرای activityها از پسزمینه بخوانید. در بسیاری از گوشیها برنامهٔ خودکارسازی به مجوز نمایش روی برنامههای دیگر نیاز دارد.
- برای اتصال هنگام روشن شدن گوشی، بهجای این کار از
اتصال خودکار(Auto connect) یا Always-on VPN (VPN همیشه روشن) استفاده کنید. مجوزها و اجرا در پسزمینه را ببینید. - برنامههای خودکارسازی میتوانند لینکهای
throne://را هم باز کنند؛ برای نمونه برای افزودن یک اشتراک. لینکهای عمیق را ببینید.