- وفقًا لـ [مستودع أرقام Bluetooth SIG المعيَّنة](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/www.bluetooth.com/specifications/assigned-numbers)، يمكننا استخدام معرِّفات الشركات التالية:
  - `0x01AB` لـ `Meta Platforms, Inc. (formerly Facebook)`
  - `0x058E` لـ `Meta Platforms Technologies, LLC`
  - `0x0D53` لـ `Luxottica Group S.p.A` (التي تصنع نظارات Meta Ray-Bans)
  - `0x03C2` لـ `Snapchat, Inc.` (التي تصنع SNAP Spectacles)
  - `0x05D6` لـ `Zhuhai Jieli Technology Co` (التي تصنع Rogbird VisionPro و Rollme VistaView)
  وهي **ثابتة وإلزامية**. بالطبع، لدى Meta وغيرها من الشركات المصنّعة منتجات أخرى تأتي مع Bluetooth وبالتالي معرِّفها الخاص، مثل نظارات الواقع الافتراضي. لذلك، فإن استخدام رموز معرِّف الشركة هذه في عملية فحص التطبيق عرضة للنتائج الإيجابية الكاذبة. لكن إذا لم تكن ترى أحدًا يرتدي نظارة Occulus Rift من حولك ولم تكن هناك مبانٍ يمكن أن يختبئوا فيها، فاحتمال أن تكون نظارات ذكية بدلًا من ذلك كبير.
- أثناء الاقتران، عادةً ما تُصدر النظارات الذكية اسم منتجها، لذا يمكننا الفحص بحثًا عن ذلك أيضًا. لكن من النادر أن نرى ذلك في الميدان. فالأشخاص الذين ينوون استخدام النظارات الذكية في الحانات والمقاهي وفي الشارع وأماكن أخرى عادةً ما يستعدون لذلك مسبقًا.
- عندما يتعرّف التطبيق على جهاز Bluetooth Low Energy (BLE) بقوة إشارة كافية (انظر RSI أدناه)، فإنه يدفع برسالة تنبيه. وهذا من شأنه أن يساعدك على التصرف وفقًا لذلك.
- علاوة على ذلك، نفحص أسماء الأجهزة المُذاعة، مثل `rayban` أو `ray-ban` أو `HeyCyan`. و`HeyCyan` هي [SDK شهيرة للنظارات الذكية من علامات تجارية متعددة](https://github.com/ebowwa/HeyCyanSmartGlassesSDK). ومن بين أجهزة *HeyCyan* تلك، قد تجد أيضًا Nilox Smart AI Glasses التي تبيعها ALDI وHofer (في النمسا). ولتعزيز ذلك، نبحث أيضًا عن `primary_UUID`، وهو معرِّف خدمة ثابت على الجانب البرمجي لتلك النظارات (`7905FFF0-B5CE-4E99-A40F-4B1E122D00D0`). ورغم أن هذا قد يتغير في المستقبل، إلا أنه من غير المرجح لأن ذلك سيجعل الأجهزة الأقدم غير قابلة للاستخدام، لذلك قد نضيف ببساطة المزيد من UUIDs إلى روتين الفحص حينها.
## الميزات
- يُظهر تطبيق *Nearby Glasses* إشعارًا عند وجود نظارات ذكية قريبة (أي جهاز BLE يحمل أحد معرِّفات الشركات المذكورة أعلاه)
- **قريب** يعني أن RSSI (قوة الإشارة) أقل من أو يساوي قيمة معينة: -75 dBm افتراضيًا. تتوافق هذه القيمة الافتراضية مع مسافة متوسطة وإشارة مقبولة.
  ### ما هو RSSI؟
- دعني أشرح قليلًا قيمة RSSI هذه:<br/>
RSSI هو اختصار لـ Received Signal Strength Indication. القيمة هي مؤشر على شدة مجال الاستقبال لتطبيقات الاتصال اللاسلكي. [لدى ويكيبيديا مقالة جيدة جدًا](https://en.wikipedia.org/wiki/Received_signal_strength_indicator) حول هذا الموضوع.
باختصار، يعتمد RSSI بشكل أساسي على:<br/>
  - قدرة إرسال الجهاز
  - تصميم الهوائي
  - الجدران والعوائق
  - امتصاص أجسام البشر للإشارة
  - الانعكاس والتداخل
  - اتجاه الجهاز<br/>
لكن في سيناريوهات BLE (Bluetooth Low Energy) النموذجية، تكون المسافة التقريبية وفقًا لـ RSSI (في الفضاء المفتوح) كالتالي: <br/>
  - -60 dBm ~ 1 – 3 م<br/>
  - -70 dBm ~ 3 – 10 م<br/>
  - -80 dBm ~ 10 – 20 م<br/>
  - -90 dBm ~ 20 – 40 م<br/>
  - -100 dBm ~ 30 – 100+ م أو قرب فقدان الإشارة<br/>
في الأماكن المغلقة، غالبًا ما تكون المسافات أقصر بكثير.<br/>
ينخفض RSSI تقريبًا وفقًا لـ<br/>
    `RSSI ≈ -10 * n * log10(distance) + constant`<br/>
- لذلك، فإن عتبة RSSI الافتراضية البالغة -75 dBm تتوافق مع حوالي 10 إلى 15 مترًا في الفضاء المفتوح و3 إلى 10 أمتار في الأماكن المغلقة أو الأماكن المزدحمة. لديك فرصة جيدة لرصد الشخص الذي يرتدي النظارات الذكية بهذه الطريقة.
- يُظهر *Nearby Glasses* سجل تصحيح اختياريًا قابلًا للتصدير (كملف txt) ويتميز بوظيفة نسخ ولصق. وهذه مخصصة للمستخدمين المتقدمين (المهووسين) ولمزيد من التصحيح.
- ضمن *الإعدادات*، يمكنك تحديد طول السجل، والتصحيح (عرض جميع عناصر الفحص أو إطارات ADV فقط).
- يمكنك أيضًا إدخال بعض **معرِّفات الشركات** كسلسلة من القيم السداسية العشرية، مثل `0x01AB,0x058E,0x0D53`. وهذا يتجاوز الكشف المدمج، بحيث يظهر إشعارك للقيم الجديدة.
- لتحقيق استمرارية أفضل، يستخدم *Foreground Service* في Android. يمكنك تعطيل هذا ضمن *الإعدادات* إذا لم تكن بحاجة إليه.
- يحدد *Notification Cooldown* ضمن *الإعدادات* مقدار الوقت الذي يجب أن يمر بين تحذيرين. القيمة الافتراضية هي 10000 مللي ثانية، أي 10 ثوانٍ. ينطبق هذا أيضًا على الكناري، فمثلًا 10 ثوانٍ تعني أنه سيبقى في حالة تأهب لمدة 10 ثوانٍ قبل أن يهدأ مرة أخرى.
- أصبح الآن أكثر توطينًا: <img src="https://raw.githubusercontent.com/yjeanrenaud/yj_nearbyglasses/HEAD/img/canary_hide.svg" align="right" alt="Drawing of a canary that hides underneath a wing" height="100" width="100">
   - الإنجليزية
   - الألمانية
   - الألمانية السويسرية
   - الفرنسية
   - الإسبانية
   - الصينية
   - الإيطالية
   - البرتغالية (البرازيل)
   - الروسية
   - التركية
   - المزيد قادم، في نهاية المطاف ([ادعم هذا المشروع من خلال المساهمة بلغتك!](https://github.com/yjeanrenaud/yj_nearbyglasses/issues/3))
- الآن لم تعد خلفية أيقونة التطبيق شفافة
- الآن نفحص بحثًا عن UUIDs أيضًا
- يدعم *Nearby Glasses* الآن الوضع الداكن (عبر إعدادات النظام)
- يجب أن تكون مشكلة التخطيط من الحافة إلى الحافة قد أُصلحت بدءًا من [v1.0.4](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) فصاعدًا.
- مرخَّص حديثًا بموجب AGPL 3.0
- قررت التنازل عن CLA. بعد بعض النقاشات مع أشخاص كانوا يعرفون أكثر مني عن المشاريع التعاونية، أدركت أن هذه كانت خطوة غير ضرورية.
- أصبح لديه الآن أيقونة مختلفة قليلًا للالتزام بـ AGPL 3.0 بشكل أكثر صرامة.
## iOS و Android
- أخيرًا، بعد ثلاثة أسابيع، أصبح منفذ iOS متاحًا. يجب أن يعمل على معظم أجهزة iPhone و iPad؛ حتى الأقدم منها (حتى iOS 16). [يتم توفير الكود المصدري وملفات المشروع](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS) أيضًا. الكود قبيح وغير تقليدي. العديد من الأساليب سريعة وغير متقنة (مثلًا أعيد استخدام ملفات json من توطين Android)، لكنه يعمل حتى الآن. *Nearby Glasses* متاح عبر [Apple App Store](https://apps.apple.com/us/app/nearby-glasses-original/id6761056896). (سُمّي original لتمييزه عن المقلّدين). يتوفر ملف .ipa للتحميل الجانبي ضمن [الإصدارات](https://github.com/yjeanrenaud/yj_nearbyglasses/releases).
  لا يعمل تطبيق iOS في الخلفية، لأنني لم أجد إمكانية لاستخدام شيء مشابه لـ `ForegroundServices` من أجل الفحص الدائم بحثًا عن BTLE ADV بسبب قيود iOS. لذلك، لا يتوفر سوى *Canary Mode* في *Nearby Glasses* على iOS. إذا كنت تعرف Swift و iOS أفضل مني (وهو أمر مرجح)، فيرجى المساهمة!
- لأن هذا المستودع يحتوي على كود تطبيقي Android و iOS معًا، أعدت تنظيم المجلدات. لذلك، يوجد [/iOS](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS) و [/Android](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android).

## الاستخدام

- راجع [الإصدارات](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) لتنزيل APK أو استخدم Google Play Store. قد يتبع F-Droid و/أو Accrescent.
<img width="135" height="300" align ="right" alt="Screenshot Nearby Glasses: Settings" src="https://assets.kitploit.com/production/public/readmes/12083/71a0271ff9172cad52e8d83ed9a29ba43b509c7b250be2a0254a5a4371ee3401.png" />

<a href="https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses" target="_blank"><img width="239" height="71" alt="Get It On Google Play" src="https://assets.kitploit.com/production/public/readmes/12083/a7dbeba4623dd255798dd1159e543cdbeeb9e43faa6db7f859b0f9ed3699932c.png" /></a> <a href="https://apps.apple.com/us/app/nearby-glasses-original/id6761056896"><img width="213" height="71" alt="Download on the App Store" src="https://assets.kitploit.com/production/public/readmes/12083/a6fa504b048d52b4e9f5108021dce33af0d96b8b78c34095072971f4a34471fa.png" /></a>
1. ثبّت التطبيق (من [الإصدارات](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) أو من [Google Play](https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses)، في الوقت الحالي) أو من [Apple App Store](https://apps.apple.com/us/app/nearby-glasses-original/id6761056896)، ثم افتحه
2. اضغط على زر *Start Scanning*
3. امنح الأذونات لتفعيل Bluetooth (إذا لم يكن مفعّلًا بالفعل) وللوصول إلى الأجهزة القريبة. تحتاج بعض إصدارات Android أيضًا إلى منحك أذونات للوصول إلى موقعك (قبل الإصدار 13، في الغالب). لا يفعل *Nearby Glasses* أي شيء بمعلومات موقعك. إذا كنت لا تصدقني، فيرجى الاطلاع على [الكود](https://github.com/yjeanrenaud/yj_nearbyglasses/tree/main/app)
4. إذا لم ترَ الفحص يبدأ، فقد تحتاج إلى تفعيل *Foreground Service* على هاتفك تحديدًا في قائمة *الإعدادات* (انظر أدناه)
5. أنت جاهز تمامًا! عند اكتشاف نظارات ذكية قريبة، سيظهر إشعار. ويستمر في الظهور حتى تضغط على *Stop Scanning* أو تُنهي التطبيق نهائيًا
7. في القائمة (أعلى اليمين، أيقونة الترس)، يمكنك إجراء بعض *الإعدادات*:
   1. *Enable Foreground Service*: بهذا تمنع Android من إيقاف التطبيق مؤقتًا وبالتالي منع تنبيهك. أوصي بإبقاء هذا مفعّلًا
   2. *RSSI threshold*: يحدد هذا الرقم السالب مدى بُعد الجهاز ليكون سببًا لتنبيه من *Nearby Glasses*. من الناحية التقنية، يشير إلى مدى قوة استقبال الإشارة. الأقرب إلى الصفر يعني إشارة أفضل، وبالتالي مسافة أقل بين هاتفك والنظارات الذكية. راجع [RSSI أعلاه للحصول على الشروحات والإرشادات](#how). أوصي بإبقائه على -75
   3. *Enable Notifications*: لن ترغب في تعطيل ذلك 
   4. Canary Mode. هذا هو الافتراضي الجديد. مع هذا، لن تتلقى إشعارات نظام تنبهك إلى نظارات ذكية قريبة، بل سترى كناريًا يشير إلى عدم وجود نظارات ذكية في الجوار. تطبيق iOS يحتوي فقط على وضع الكناري بسبب القيود التقنية. <img src="https://raw.githubusercontent.com/yjeanrenaud/yj_nearbyglasses/HEAD/img/canary.svg" alt="Drawing of a canary" width="100" height="100" alignt="left"> 
   5. *Notification/Canary Cooldown*: هنا تحدد عدد الإشعارات التي تريد تلقيها حول النظارات الذكية المكتشفة قريبة أو المدة التي يجب أن يختبئ فيها الكناري. اخترت 10 ثوانٍ (10000 مللي ثانية) كقيمة افتراضية. بهذه الطريقة، لن تفوتك الإشعارات وفي الوقت نفسه لن تزعجك كثيرًا أو تستنزف بطاريتك بسرعة كبيرة
   6. *Enable Log Display*: قد يعفيك تعطيل هذا من بعض استهلاك البطارية. هذا معطّل في وضع الكناري.
   7. *Debug*: مطلوب لرؤية أكثر من مجرد إطارات BLE المطابقة في إطار عرض السجل. إنه مفيد لمعرفة ما إذا كانت الأمور تعمل. هذا معطّل في وضع الكناري.
   8. *Max log lines*: إلى أي مدى قد يصل السجل. يبدو أن 200 توازن جيد بين عمر البطارية وقابلية استخدام السجل (للمهووسين مثلي). هذا معطّل في وضع الكناري.
   9. *BLE ADV only*: يستبعد هذا إطارات Bluetooth LE الأخرى من السجل لتحسين قابلية القراءة. هذا معطّل في وضع الكناري.
   10. *Override Company IDs*: إذا أردت، يمكنك أن تجعل *Nearby Glasses* ينبهك إلى أجهزة أخرى غير المحددة أعلاه. مفيد للتصحيح، على الأقل بالنسبة لي. اتركه فارغًا إذا لم تكن بحاجة إليه أو لا تعرف ماذا تفعل به
   11. يتم حفظ كل إعداد وتنفيذه فورًا. للعودة، استخدم زر الرجوع أو الإيماءة
8. تتيح لك وظيفة التصدير مشاركة ملف نصي لسجل التطبيق. للمهووسين مثلي
9. يمكنك أيضًا نسخ ولصق السجل من خلال النقر على إطار عرض السجل

## المهام المتبقية
- **إنه يعمل الآن في الميدان!** تمكنت من جعل بعض الأشخاص يختبرونه مع نظارات ذكية موثّقة من حولهم. شكر خاص لـ Lena!
- راجع [الإصدارات](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) لتنزيل APK. 
- دفعت [*Nearby Glasses* إلى Google Play](https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses) أيضًا. ومع ذلك، سأنشر دائمًا [الإصدارات هنا على GitHub](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) و[في مكان آخر](https://yves.app/nearbyglasses/latest.apk)، لأولئك الذين يتجنبون Google Play.

---

- إضافة خيار لتعيين النتائج الإيجابية الكاذبة إلى قائمة تجاهل. ربما في الإشعار؟
- أنا لست خبيرًا في BT أو Android على الإطلاق. بحسب ما تعلمته، يمكن للمرء أيضًا التعمق أكثر في اتصالات النظارات الذكية من خلال التقاط حركة مرور BLE. وبفعل ذلك، لن نحتاج على الأرجح إلى الاعتماد على سلوك الجهاز وفقًا لمواصفات BT بل يمكننا أيضًا استخدام الاستدلالات على عمليات نقل الحركة المشفرة دون الكثير من النتائج الإيجابية الكاذبة. لكنني لم أطلع على حزم حركة مرور BT منذ أكثر من عشر سنوات. أنا سعيد لأنني تذكرت إطارات ADV... لذا إذا كان بإمكان أي شخص المساعدة في هذا، فسيكون ذلك موضع تقدير كبير!
---
- إضافة **المزيد من معرِّفات الشركات المصنّعة** للنظارات الذكية. في الوقت الحالي، هم Meta و Oakley و Snap. ستكون قائمة بالنظارات الذكية المزودة بكاميرات متاحة مفيدة أيضًا. فتحت [ISSUE لهذا](https://github.com/yjeanrenaud/yj_nearbyglasses/issues/56)، حتى يتمكن الناس من **المساعدة** بإرسال سجلاتهم (وهي آمنة تمامًا، في رأيي) عند مصادفة نظارات ذكية أخرى تسجّل.
- اعتبارًا من 24 مارس 2026، أصبح إصدار iOS متاحًا أيضًا.
- يبدو أن **مشكلة التخطيط** مع **أجهزة Google Pixel** قد أُصلحت اعتبارًا من الإصدار 1.0.3. إذا كنت لا تزال غير قادر على الوصول إلى القائمة لأنها مختلطة مع شريط الحالة بطريقة ما. سأبحث في ذلك في أقرب وقت ممكن. في هذه الأثناء، حاول ضبط شاشتك على الوضع الأفقي وقم بالتدوير *باتجاه عقارب الساعة (إلى اليمين)*. 

## الحلول التقنية؟
أعلم أن هذا قد يكون مكانًا غريبًا لفعل ذلك، لكن اسمعني في هذا. أنا أدرك أن هذا حل تقني لمشكلة اجتماعية، وهي نفسها تتضخم بفعل التقنية.
لا أريد الترويج للحلول التقنية ولا أريد أن يشعر الناس بأمان زائف. لا يزال هذا نهجًا غير كامل وعلى الأرجح سيبقى كذلك دائمًا. ليس كل شيء جيدًا فقط لأن هذا التطبيق موجود الآن. نحتاج إلى حلول أفضل للحد من تقنيات المراقبة وانتهاك الخصوصية.

## البناء من المصدر
بما أن *Nearby Glasses* مفتوح المصدر، يمكنك أيضًا بناء التطبيق بنفسك من الكود المصدري. وهذا يضمن عدم تضمين مكتبات أخرى في APK وتحصل على ما تريد.

يرجى ملاحظة أن هذا التطبيق يُبنى على:
- Gradle Wrapper: 9.3.1
- Android Gradle Plugin: 8.13.2
- Kotlin: 1.9.22
- compileSdk: 36
- targetSdk: 36
- minSdk: 26
- لا توجد نكهات منتج
- المستودعات: google() و mavenCentral() فقط
- لا توجد إضافات Google Services أو Firebase

### المتطلبات

- **JDK 17** (مطلوب — يستهدف المشروع Java 17)
- **Android SDK Platform 35** مثبّتة  
  - compileSdk = 35  
  - targetSdk = 35  
- Git
### بناء APK خطوة بخطوة```bash
#Verify Java version:

 $java -version
#It must report Java 17.

#Get the source code
 $git clone https://github.com/yjeanrenaud/yj_nearbyglasses
 $cd yj_nearbyglasses

#Build Debug
 $./gradlew clean assembleDebug

#Build Release (with your own signature cert)
 $./gradlew clean assembleRelease

#Build unsigned Release for IzzyOnDroid / F-Droid
 $./gradlew clean izziFdroid 

#Run and Test
 $./gradlew test lint