phongent ٹیوٹوریل: iPhone یا Android سے متعدد فون Agents کو باہمی طور پر کنٹرول کریں

phongent کیا ہے

phongent متعدد ڈیوائسز کے Agents کو باہمی طور پر کنٹرول کرنے والا ایک منصوبہ ہے۔ یہ آپ کو قدرتی زبان کے ذریعے تمام ڈیوائسز، کسی ڈیوائس گروپ یا مخصوص ڈیوائس کو کام تفویض کرنے، اور ایک ہی انٹرفیس میں پیش رفت، نتائج، نوٹیفکیشن پیغامات اور Android ڈیوائسز کی لائیو اسکرین دیکھنے دیتا ہے۔

iOS اور Android دونوں مرکزی کنٹرولر کے طور پر کام کر سکتے ہیں اور Android ایگزیکیوٹرز سے جڑنے اور انہیں منظم کرنے کی ذمہ داری سنبھالتے ہیں۔ دونوں میں کام کی تقسیم، نتائج دیکھنا، پیغامات کا انتظام، لائیو فلوٹنگ ونڈو اور کنٹرول سنبھالنے کی سہولت موجود ہے؛ صرف Android مقامی App کے آپریشنز براہِ راست انجام دے سکتا ہے۔

نوٹ: iOS فی الحال صرف مرکزی کنٹرولر کے طور پر Android ایگزیکیوٹرز سے جڑتا ہے؛ یہ iPhone کی مقامی App کے آپریشنز انجام نہیں دے سکتا۔

اہم خصوصیات

• متعدد ڈیوائسز کو کام تفویض کرنا: ڈیوائس کو دیر تک دبائیں اور کام بیان کریں، یا مرکزی کنٹرولر کے Task Agent کو خود فیصلہ کرنے دیں کہ کام ڈیوائسز کو کیسے بھیجنا ہے۔
• ڈیوائس گروپس میں تعاون: پورے ڈیوائس گروپ کو منتخب کر کے کام بڑی تعداد میں انجام دیں، یا مختلف گروپس اور گروپ کے اندر کسی مخصوص ڈیوائس کے لیے الگ کام مقرر کریں۔
• مواد بنانا اور تقسیم کرنا: مرکزی کنٹرولر کا ماڈل متعدد تحریری مواد اور ٹیکسٹ کارڈز بنا سکتا ہے، پھر مختلف مواد متعلقہ ڈیوائسز کو دے سکتا ہے، اور تصاویر بھی منسلک کی جا سکتی ہیں۔
• Android لائیو فلوٹنگ ونڈو: Android کی ورچوئل اسکرین دیکھیں اور کلک، سوائپ اور ان پٹ کے ذریعے ڈیوائس کا کنٹرول سنبھالیں۔ یہ سہولت بطورِ ڈیفالٹ فعال ہے اور Settings میں بند کی جا سکتی ہے۔
• پیغامات کا مرکزی انتظام: نوٹیفکیشنز کو ڈیوائس، App اور پیغام کے ماخذ کے لحاظ سے منظم کریں، اور ہدف Android ڈیوائس کے Agent سے پیغام کا جواب دلوائیں۔
• مرکزی کنفیگریشن: میموری، مہارتیں، شیڈول شدہ کام اور آپریشن روٹس کا انتظام کریں؛ ایک ڈیوائس یا متعدد ڈیوائسز منتخب کی جا سکتی ہیں۔
• کنکشن کا انتظام: لوکل نیٹ ورک دریافت، پہلی اجازت، ایک کلک سے کنکشن، کنکشن ٹوٹنے کے بعد دوبارہ جڑنا، ڈیوائس کا نام تبدیل کرنا اور ڈیوائس گرڈ معاونت یافتہ ہیں۔

انسٹالیشن سے پہلے تیاری

ڈیوائس اور سسٹم کی ضروریات

• کم از کم ایک Android ڈیوائس ایگزیکیوٹر کے طور پر تیار رکھیں۔
• مرکزی کنٹرولر iPhone یا Android ڈیوائس ہو سکتا ہے۔
• مرکزی کنٹرولر اور ایگزیکیوٹر ایک ہی لوکل نیٹ ورک سے منسلک ہونے چاہییں۔
• Android کا کم از کم انسٹالیشن ورژن Android 11 ہے؛ حقیقی آپریشن کی صلاحیت سسٹم ورژن اور اجازتوں کی Settings سے بھی متاثر ہوگی۔
• iOS کا کم از کم Deployment ورژن iOS 17 ہے؛ فی الحال Xcode کے ذریعے Build، Sign اور Install کرنا ضروری ہے۔

درست انسٹالیشن پیکیج منتخب کریں

Android صارفین منصوبے کے Release صفحے سے phongent.apk ڈاؤن لوڈ کر سکتے ہیں۔ phongent منصوبے کی فراہم کردہ Build استعمال کریں؛ upstream منصوبے کی APK کو متبادل کے طور پر استعمال نہ کریں، کیونکہ upstream ورژن میں متعدد ڈیوائسز کے گروپ کنٹرول کے لیے درکار APIs موجود نہ بھی ہوں۔

فوری کنفیگریشن اور کنکشن

1. App انسٹال کریں۔ Android ڈیوائس پر phongent APK انسٹال کریں۔ iOS مرکزی کنٹرولر کے لیے macOS پر Xcode کے ذریعے Build، Sign اور Install کرنا ضروری ہے۔
2. Android ایگزیکیوٹر سیٹ کریں۔ App میں مطلوبہ ماڈل اور فون آپریشن کی صلاحیتیں کنفیگر کریں، اور ضرورت کے مطابق Accessibility، نوٹیفکیشن پڑھنے وغیرہ کی اجازتیں دیں۔ بنیادی فون آپریشن کی Settings کے لیے منصوبے کی Settings Guide دیکھیں۔
3. ایگزیکیوٹر سروس چلتی رکھیں۔ تصدیق کریں کہ Android سروس شروع ہو چکی ہے، اور مرکزی کنٹرولر کو Android ایگزیکیوٹر کے ساتھ ایک ہی لوکل نیٹ ورک سے منسلک کریں۔
4. ڈیوائس مربوط کریں۔ مرکزی کنٹرولر کے “Devices” صفحے پر دریافت شدہ Android ڈیوائس منتخب کریں، یا “Connect All” استعمال کریں۔ پہلی بار کنکشن کے وقت Android ڈیوائس پر اجازت کی تصدیق ضروری ہے۔
5. مرکزی کنٹرولر کا ماڈل کنفیگر کریں۔ مرکزی کنٹرولر کی Settings میں جا کر وہ ماڈل کنفیگر کریں جو کام سمجھنے اور بھیجنے کا ذمہ دار ہے۔ متعلقہ App اکاؤنٹس کو متعلقہ ایگزیکیوٹر ڈیوائس پر لاگ اِن ہونا چاہیے۔
6. تعاون شروع کریں۔ “agent” صفحے پر جائیں، تمام ڈیوائسز، کسی ڈیوائس گروپ یا ایک ڈیوائس کو منتخب کریں، پھر قدرتی زبان میں کام درج کریں۔

پہلی اجازت مکمل ہونے کے بعد ڈیوائس دوبارہ کنکشن قائم کر سکتی ہے۔ اگر ڈیوائس دریافت نہ ہو تو App دوبارہ انسٹال کرنے کے بجائے پہلے لوکل نیٹ ورک کنکشن اور Android سروس کی حالت چیک کریں۔

چار اہم داخلی صفحات

• Devices: Android ڈیوائسز دریافت، مربوط، نام تبدیل اور گروپ کریں۔
• agent: کام تقسیم کریں اور پیش رفت، نتائج اور لائیو فلوٹنگ ونڈو دیکھیں۔
• Messages: نوٹیفکیشنز کو ڈیوائس، App اور ماخذ کے لحاظ سے دیکھیں اور جواب دینے کا کام شروع کریں۔
• Settings: مرکزی کنٹرولر کا ماڈل، ایگزیکیوٹر کی صلاحیتیں اور متعلقہ Sync اختیارات کنفیگر کریں۔

بنیادی استعمال: ڈیوائسز کو کام بھیجنا

مختلف ڈیوائسز کو مختلف کام دیں

فرض کریں ڈیوائسز کے نام A اور B ہیں؛ آپ کام میں براہِ راست بتا سکتے ہیں کہ ہر ڈیوائس کو کیا کرنا ہے:

A Xiaohongshu کا ہوم پیج کھول کر اسکرین شاٹ لے، B براؤزر کھول کر آج کا موسم دیکھے۔

جمع کرانے کے بعد آپ ہر ڈیوائس کے لحاظ سے پیش رفت اور نتائج دیکھ سکتے ہیں۔ اگر Android ڈیوائس کے آپریشن کا مشاہدہ یا تصحیح ضروری ہو تو متعلقہ ڈیوائس کی لائیو فلوٹنگ ونڈو کھول کر کلک، سوائپ یا ان پٹ کے ذریعے کنٹرول سنبھالیں۔

ڈیوائس گروپ کے لحاظ سے اجتماعی تعاون

مواد تیار کرنے، جانچ یا آپریشن جیسے دہرائے جانے والے کاموں کے لیے پہلے ڈیوائس گروپ بنائیں، پھر گروپ کے نام کے ذریعے کام تقسیم کریں:

مواد گروپ کی ہر ڈیوائس الگ پروڈکٹ تعارف کا مسودہ تیار کرے، جانچ گروپ ہر ڈیوائس کے کام کی حالت دیکھے۔
مواد گروپ میں A کو موجودہ مواد مرتب کرنے کا کام دیں، باقی ڈیوائسز مسودے تیار کرتی رہیں۔

اس طرح کی تفصیل پورے گروپ کے لیے مشترکہ ہدف مقرر کر سکتی ہے، یا گروپ کے اندر کسی ایک ڈیوائس کے کام کو تبدیل کر سکتی ہے۔

مختلف مواد بنائیں اور تقسیم کریں

جب ہر ڈیوائس کو مختلف مواد پر کام کرنا ہو تو مرکزی کنٹرولر کے ماڈل سے الگ الگ مواد بنوا کر ایک ایک ڈیوائس کو بھیجنے کی ہدایت کریں:

مواد گروپ کی ہر ڈیوائس کے لیے مختلف عنوان، متن اور ٹیکسٹ کارڈز بنائیں،
متعلقہ ڈیوائس کو الگ الگ بھیجیں، مسودے کے طور پر محفوظ کریں، ابھی شائع نہ کریں۔

کام میں “مسودے کے طور پر محفوظ کریں، ابھی شائع نہ کریں” جیسی پابندیاں واضح طور پر شامل کرنے سے مطلوبہ آپریشن کی حدود بہتر طور پر بیان ہوتی ہیں۔ اصل عمل درآمد پھر بھی ماڈل کی کنفیگریشن، ہدف App کی حالت، اکاؤنٹ لاگ اِن اور دی گئی سسٹم اجازتوں پر منحصر ہوگا۔

ڈیوائس گروپس بنانا اور منظم کرنا

1. “Devices” صفحہ کھولیں۔ نیچے موجود گرڈ میں موجودہ مربوط ڈیوائسز، ہر ڈیوائس کا نام اور اس کا گروپ دکھائی دے گا۔
2. “Groups” پر کلک کریں اور مطلوبہ ڈیوائسز منتخب کریں۔
3. موجودہ گروپ منتخب کریں یا نیا گروپ بنائیں۔
4. “Move N Devices” پر کلک کر کے بڑی تعداد میں منتقلی مکمل کریں۔

ہر ڈیوائس صرف ایک گروپ کا حصہ ہو سکتی ہے؛ منتقلی کے بعد وہ پچھلے گروپ سے نکل جائے گی۔ جن ڈیوائسز کو دستی طور پر گروپ نہیں کیا گیا انہیں “Default Group” میں شامل کیا جائے گا۔

ڈیوائس کے اوتار یا کارڈ کو دیر تک دبانے سے ڈیوائس کا نام تبدیل یا گروپ منتقل کیا جا سکتا ہے۔ ڈیوائس کا نیا نام متعلقہ Android App کے ساتھ Sync کرنے کی کوشش کی جائے گی، لیکن اس کے لیے ایگزیکیوٹر کی جانب سے متعلقہ API کی معاونت ضروری ہے۔

گروپ کی معلومات موجودہ مرکزی کنٹرولر پر محفوظ ہوتی ہیں اور خودکار طور پر دوسرے مرکزی کنٹرولر سے Sync نہیں ہوتیں۔ متعدد مرکزی کنٹرولرز کے ماحول میں ہر مرکزی کنٹرولر کے گروپس الگ الگ برقرار رکھنے ہوں گے۔

نوٹیفکیشنز کو مرکزی طور پر دیکھیں اور جواب دیں

phongent اجازت یافتہ Android نوٹیفکیشنز پڑھ سکتا ہے اور انہیں ڈیوائس، App اور پیغام کے ماخذ کے لحاظ سے منظم کر سکتا ہے۔ “Messages” صفحے پر جا کر نوٹیفکیشن کی تفصیل دیکھیں اور جواب دینے کا کام متعلقہ Android ڈیوائس کے Agent کو دیں۔

1. یقینی بنائیں کہ ہدف Android ڈیوائس کو نوٹیفکیشن پڑھنے کی اجازت دی گئی ہے۔
2. مرکزی کنٹرولر پر “Messages” داخلی صفحہ کھولیں۔
3. ڈیوائس، App یا ماخذ کے ذریعے مطلوبہ نوٹیفکیشن تلاش کریں۔
4. نوٹیفکیشن کی تفصیل کھولیں اور جواب دینے کا کام شروع کریں۔
5. ہدف Android ڈیوائس کا Agent اصل جواب دینے کا عمل مکمل کرے گا۔

اگر مرکزی کنٹرولر پر نوٹیفکیشن نظر نہ آئیں تو پہلے ہدف Android ڈیوائس کی نوٹیفکیشن پڑھنے کی اجازت، ایگزیکیوٹر سروس اور کنکشن کی حالت چیک کریں۔

اعلیٰ درجے کے استعمال کی تجاویز

کام کی تفصیل کو آسانی سے قابلِ عمل بنائیں

• ڈیوائس یا گروپ کا نام واضح لکھیں: مثلاً “مواد گروپ”، “جانچ گروپ” یا “A ڈیوائس”۔
• مختلف اہداف الگ کریں: ہر ڈیوائس کے آپریشن واضح طور پر بیان کریں؛ متعدد ڈیوائسز کی ضروریات کو ایک مبہم جملے میں نہ ملائیں۔
• حتمی حالت بتائیں: مثلاً “اسکرین شاٹ کے بعد نتیجہ واپس کریں”، “مسودے کے طور پر محفوظ کریں”، “ابھی شائع نہ کریں”۔
• گروپ کے اندر کام تبدیل کریں: پہلے پورے گروپ کو ہدف دیں، پھر الگ سے بتائیں کہ کسی مخصوص ڈیوائس کو کیا مختلف کام کرنا ہے۔
• اکاؤنٹ پہلے چیک کریں: تھرڈ پارٹی App سے متعلق کاموں کے لیے متعلقہ Android ڈیوائس پر پہلے سے اکاؤنٹ لاگ اِن کریں۔

لائیو فلوٹنگ ونڈو کا مناسب استعمال

لائیو فلوٹنگ ونڈو Agent کے آپریشن کا مشاہدہ کرنے یا خودکار عمل کے دوران صفحہ تبدیل ہونے پر دستی طور پر کنٹرول سنبھالنے کے لیے موزوں ہے۔ یہ بطورِ ڈیفالٹ فعال ہوتی ہے؛ اگر لائیو اسکرین درکار نہ ہو تو اسے Settings میں بند کیا جا سکتا ہے۔

ایگزیکیوٹرز کی بڑی تعداد میں دیکھ بھال

میموری، مہارتیں، شیڈول شدہ کام اور آپریشن روٹس جیسی Settings کو مرکزی طور پر منظم کیا جا سکتا ہے، اور ہر خصوصیت کے لیے ایک یا متعدد ڈیوائسز منتخب کی جا سکتی ہیں۔ بڑی تعداد میں تبدیلی سے پہلے منتخب ڈیوائسز کی حد کی تصدیق کریں، تاکہ کسی ایک ڈیوائس کے لیے مخصوص Setting پورے گروپ پر لاگو نہ ہو جائے۔

کنکشن کے مسائل حل کریں

• یقینی بنائیں کہ مرکزی کنٹرولر اور ایگزیکیوٹر ایک ہی لوکل نیٹ ورک میں ہیں۔
• یقینی بنائیں کہ Android ایگزیکیوٹر سروس اب بھی چل رہی ہے۔
• پہلی بار کنکشن کے وقت Android ڈیوائس پر اجازت مکمل کریں۔
• اجازت یافتہ ڈیوائس کا کنکشن ٹوٹنے کے بعد دوبارہ کنیکٹ کرنے یا “Connect All” استعمال کرنے کی کوشش کریں۔
• ڈیوائس گرڈ میں صرف مربوط ڈیوائسز دکھائی دیتی ہیں؛ کسی ڈیوائس کا نظر نہ آنا اس کے کامیابی سے مربوط ہونے کی علامت نہیں ہے۔

Source سے Android ورژن بنائیں

منصوبے کی Android App، مرکزی کنٹرولر انٹرفیس اور ایگزیکیوٹر سروس app/ میں موجود ہیں، جبکہ Agent کی بنیادی صلاحیتیں core/ میں ہیں۔ Build کے لیے JDK 17 اور Android SDK درکار ہیں؛ فی الحال compileSdk 36 استعمال ہو رہا ہے۔

./gradlew :app:assembleDebug

Debug APK app/build/outputs/apk/debug/ میں بنے گی۔ انسٹال کرنے سے پہلے تصدیق کریں کہ Build کے نتیجے کو آپ کی اپنی Development Signature سے Sign کیا گیا ہے۔

Source سے iOS مرکزی کنٹرولر بنائیں

iOS Build کے لیے macOS اور ایسا Xcode درکار ہے جو منصوبے کے استعمال کردہ SDK کو سپورٹ کرتا ہو۔ کم از کم Deployment ورژن iOS 17 ہے۔

1. Xcode میں ios/MikaRemote.xcodeproj کھولیں۔
2. MikaRemote Scheme منتخب کریں۔
3. Signing Settings میں اپنی Development Team منتخب کریں۔
4. ہدف iPhone مربوط کریں، پھر Build اور Install کریں۔

Repository کی ios/ ڈائریکٹری میں iOS مرکزی کنٹرولر، Components اور Live Activities شامل ہیں؛ tools/android-emulators/ Android Emulator کے باہمی ٹیسٹنگ ٹولز فراہم کرتا ہے؛ Settings Guide، پروٹوکول اور Verification Records docs/ میں موجود ہیں۔

سکیورٹی نوٹ: ماڈل کیز، اکاؤنٹ کی اسناد اور مقامی Signing Materials کو Source Code میں نہیں لکھنا چاہیے اور نہ ہی Version Control میں Commit کرنا چاہیے۔

خلاصہ

phongent متعدد Android ڈیوائسز کو مرکزی طور پر منظم کیے جانے والے Agent Execution Environment میں منظم کرتا ہے اور iPhone یا Android ڈیوائس کو مرکزی کنٹرولر کے طور پر استعمال کرنے دیتا ہے۔ ایگزیکیوٹر کی اجازتیں، لوکل نیٹ ورک کنکشن اور مرکزی کنٹرولر کا ماڈل کنفیگر کرنے کے بعد آپ ایک ڈیوائس، ڈیوائس گروپ یا تمام ڈیوائسز کو کام دے سکتے ہیں، اور نتائج، لائیو اسکرین اور نوٹیفکیشن پیغامات دیکھ سکتے ہیں۔ یہ منصوبہ Mika کی بنیاد پر تیار کیا گیا ہے اور Apache License 2.0 کے تحت جاری ہے۔