- وفقًا لمستودع [أرقام الشركات المعيّنة من Bluetooth SIG](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/www.bluetooth.com/specifications/assigned-numbers)، يمكننا استخدام معرّفات الشركات هذه:
  - `0x01AB` لـ `Meta Platforms, Inc. (المعروفة سابقًا باسم 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 منخفض الطاقة (BLE) بإشارة قوية بما يكفي (انظر RSSI أدناه)، سيدفع برسالة تنبيه. وهذا من شأنه أن يساعدك على التصرف وفقًا لذلك.
- علاوة على ذلك، نبحث عن أسماء الأجهزة التي يتم بثها، مثل `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 ديسيبل ميلي واط افتراضيًا. تتوافق هذه القيمة الافتراضية مع مسافة متوسطة وإشارة مقبولة إلى حد ما.
  ### ما هو RSSI؟
- دعني أشرح قليلاً قيمة RSSI:<br/>
RSSI هو اختصار لـ Received Signal Strength Indication (مؤشر قوة الإشارة المستقبَلة). القيمة هي مؤشر على قوة مجال الاستقبال لتطبيقات الاتصالات اللاسلكية. [لدى ويكيبيديا مقال جيد جدًا](https://en.wikipedia.org/wiki/Received_signal_strength_indicator) حول هذا الموضوع.
باختصار، يعتمد RSSI بشكل أساسي على:<br/>
  - قوة إرسال الجهاز
  - تصميم الهوائي
  - الجدران والعوائق
  - امتصاص الأجسام البشرية للإشارة
  - الانعكاس والتداخل
  - اتجاه الجهاز<br/>
لكن في سيناريوهات BLE (Bluetooth منخفض الطاقة) النموذجية، المسافة التقريبية لـ RSSI (في الفضاء المفتوح) هي: <br/>
  - -60 ديسيبل ميلي واط ~ 1 – 3 أمتار<br/>
  - -70 ديسيبل ميلي واط ~ 3 – 10 أمتار<br/>
  - -80 ديسيبل ميلي واط ~ 10 – 20 مترًا<br/>
  - -90 ديسيبل ميلي واط ~ 20 – 40 مترًا<br/>
  - -100 ديسيبل ميلي واط ~ 30 – 100+ متر أو قرب فقدان الإشارة<br/>
في الأماكن المغلقة، تكون المسافات غالبًا أقصر بكثير.<br/>
ينخفض RSSI تقريبًا وفقًا لـ<br/>
    `RSSI ≈ -10 * n * log10(distance) + constant`<br/>
- لذلك، فإن عتبة RSSI الافتراضية البالغة -75 ديسيبل ميلي واط تتوافق مع حوالي 10 إلى 15 مترًا في الفضاء المفتوح و3 إلى 10 أمتار في الأماكن المغلقة أو المزدحمة. لديك فرصة جيدة لرصد الشخص الذي يرتدي النظارات الذكية بهذه الطريقة.
- يعرض *Nearby Glasses* سجل تصحيح اختياري قابل للتصدير (كملف نصي) ويوفر وظيفة نسخ ولصق. هذه الميزات للمستخدمين المتقدمين (المهووسين) ولمزيد من التصحيح.
- ضمن *الإعدادات*، يمكنك تحديد طول السجل، والتصحيح (عرض جميع عناصر الفحص أو إطارات ADV فقط).
- يمكنك أيضًا إدخال بعض **معرّفات الشركات** كسلسلة من القيم السداسية العشرية، مثل `0x01AB,0x058E,0x0D53`. هذا يتجاوز الكشف المدمج، بحيث يظهر إشعارك للقيم الجديدة.
- لتحسين الاستمرارية، يستخدم *خدمة المقدمة* في Android. يمكنك تعطيل ذلك ضمن *الإعدادات* إذا لم تكن بحاجة إليه.
- يحدد *فترة التهدئة للإشعارات* ضمن *الإعدادات* مقدار الوقت الذي يجب أن يمر بين تحذيرين. الافتراضي هو 10000 مللي ثانية، أي 10 ثوانٍ. ينطبق هذا أيضًا على وضع الكناري، على سبيل المثال 10 ثوانٍ تعني أنه سيبقى في حالة تنبيه لمدة 10 ثوانٍ قبل أن يهدأ مرة أخرى.
- أصبح الآن أكثر تعددًا للغات: <img src="https://raw.githubusercontent.com/yjeanrenaud/yj_nearbyglasses/HEAD/img/canary_hide.svg" align="right" alt="رسم لكناري يختبئ تحت جناح" 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). بعد بعض النقاشات مع أشخاص يعرفون أكثر مني عن المشاريع التعاونية، اكتسبت insight أن هذه كانت خطوة غير ضرورية.
## 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. لذلك، لا يوجد سوى *وضع الكناري* متاح في *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="لقطة شاشة Nearby Glasses: الإعدادات" 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="احصل عليه من 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="نزّله من 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. اضغط على زر *بدء الفحص*
3. امنح الأذونات لتفعيل Bluetooth (إذا لم يكن مفعلاً بالفعل) وللوصول إلى الأجهزة القريبة. تتطلب بعض إصدارات Android أيضًا منح أذونات للوصول إلى موقعك (قبل الإصدار 13، في الغالب). *Nearby Glasses* لا يفعل شيئًا بمعلومات موقعك. إذا كنت لا تصدقني، يرجى الاطلاع على [الكود](https://github.com/yjeanrenaud/yj_nearbyglasses/tree/main/app)
4. إذا لم ترَ الفحص يبدأ، فقد تحتاج إلى تفعيل *خدمة المقدمة* على هاتفك المحدد في قائمة *الإعدادات* (انظر أدناه)
5. كل شيء جاهز! عندما يتم اكتشاف نظارات ذكية قريبة، سيظهر إشعار. يستمر ذلك حتى تضغط *إيقاف الفحص* أو تنهي التطبيق نهائيًا
7. في القائمة (أعلى اليمين، أيقونة الترس)، يمكنك إجراء بعض *الإعدادات*:
   1. *تفعيل خدمة المقدمة*: بهذا تمنع Android من إيقاف التطبيق مؤقتًا وبالتالي تمنعه من تنبيهك. أوصي بترك هذا مفعلاً
   2. *عتبة RSSI*: يحدد هذا الرقم السالب مدى بُعد الجهاز الذي قد يكون سببًا للتنبيه من *Nearby Glasses*. تقنيًا، يشير إلى مدى قوة استقبال الإشارة. الاقتراب من الصفر يعني إشارة أفضل، وبالتالي مسافة أقل بين هاتفك والنظارات الذكية. انظر [RSSI أعلاه للشروحات والإرشادات](#how). أوصي بتركه على -75
   3. *تفعيل الإشعارات*: لن ترغب في تعطيل ذلك
   4. وضع الكناري. هذا هو الوضع الافتراضي الجديد. بهذا، لن تحصل على إشعارات نظام تنبهك لوجود نظارات ذكية قريبة، بل سترى كناريًا يشير إلى عدم وجود نظارات ذكية حولك. تطبيق iOS يحتوي فقط على وضع الكناري بسبب القيود التقنية. <img src="https://raw.githubusercontent.com/yjeanrenaud/yj_nearbyglasses/HEAD/img/canary.svg" alt="رسم لكناري" width="100" height="100" alignt="left">
   5. *فترة التهدئة للإشعارات/الكناري*: هنا، تحدد عدد الإشعارات التي تريد الحصول عليها حول النظارات الذكية القريبة أو المدة التي يجب أن يختبئ فيها الكناري. اخترت 10 ثوانٍ (10000 مللي ثانية) كقيمة افتراضية. بهذه الطريقة، لن تفوت الإشعار بينما لن يزعجك كثيرًا أو يستنزف بطاريتك بسرعة كبيرة
   6. *تفعيل عرض السجل*: تعطيل هذا قد يوفر لك بعض البطارية. هذا معطل في وضع الكناري.
   7. *التصحيح*: مطلوب لرؤية أكثر من مجرد إطارات BLE المطابقة في إطار عرض السجل. إنه مفيد لمعرفة ما إذا كانت الأمور تعمل. هذا معطل في وضع الكناري.
   8. *الحد الأقصى لأسطر السجل*: ما المدة التي قد يصل إليها السجل. يبدو أن 200 هو توازن جيد بين عمر البطارية وفائدة السجل (للمهووسين مثلي). هذا معطل في وضع الكناري.
   9. *إطارات BLE ADV فقط*: يستبعد هذا إطارات Bluetooth LE الأخرى من السجل لتحسين قابلية القراءة. هذا معطل في وضع الكناري.
   10. *تجاوز معرّفات الشركات*: إذا أردت، يمكنك جعل *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 أو إضافات 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