انتقل إلى المحتوى
YA
كل الأعمال
نموذج أوليأندرويدذكاء اصطناعي

Kaffكفّ

اقبض على الملف بيدك، وافتح كفّك أمام الهاتف الآخر — فينتقل. دون إنترنت.

الحالة
اكتملت ست مراحل تطوير؛ وأُنجزت الجولة الأولى من الاختبار الميداني على هواتف حقيقية.
الفترة
2026
المنصات
Android
المستودع
خاص — متاح عند الطلب
منشور
—
Kكفّ

Kaff

  • CameraX
  • MediaPipe HandLandmarker
  • GestureEngine
  • Send VM
  • Receive VM
  • Fist → grab
  • Palm 700 ms → accept
  • SendController + reducer
  • ReceiveController + reducer
  • Nearby BYTES + FILE
  • MediaStore
  • SHA-256 verify
  • Room history

01نظرة عامة

تتعرف متابعة اليد على الجهاز على قبضة اليد لالتقاط الملف، وعلى الكف المفتوح لمدة 0.7 ثانية لقبوله. تنتقل الملفات من جهاز لجهاز عبر Google Nearby Connections (بلوتوث للبدء ثم Wi-Fi Direct)، خلف رمز اقتران من ٤ أرقام، ويُتحقق من كل ملف بـ SHA-256 قبل حفظه.

بالأرقام

مُقاس، ٥٠٠ ميغابايت عبر Nearby
12.5 MB/s
مُقاس، ٥٠٠ ميغابايت عبر Nearby
docs/DECISIONS.md
اختباراً على JVM
104
اختباراً على JVM
README
ملف Kotlin
113
ملف Kotlin
source tree
  1. 02المشكلة

    إرسال ملف بين هاتفين متجاورين ما زال يعني تطبيقات وحسابات وكوابل أو إنترنت. والحركة يجب أن تكون طبيعية كأنك تناول شيئاً بيدك.

  2. 03الحل

    يغذّي MediaPipe HandLandmarker (المعالج الرسومي مع بديل المعالج) محرّك الإيماءات؛ ومنطق النقل زوج من آلات الحالة النقية للإرسال والاستقبال فوق حمولات Nearby، والحفظ في MediaStore مع فحص السلامة.

04الميزات الرئيسية

  1. 01

    الاقتران قبل أي نقل

    يعرض الهاتفان الأرقام الأربعة نفسها، ولا يُقبل شيء حتى يؤكد المستقبل. فالإيماءة مُشغِّل لا وسيلة تحقق من الهوية.

  2. 02

    السلامة

    التحقق من SHA-256 والحجم أثناء الحفظ؛ والملفات التالفة لا تظهر في المعرض أبداً. حتى ٢٠ ملفاً في النقل الواحد.

  3. 03

    واعٍ باستهلاك الطاقة

    إطفاء الكاميرا تلقائياً، ونحو ١٥ إطاراً/ث في وضع توفير البطارية، وإيقاف مؤقت عند سخونة الهاتف.

  4. 04

    مختبر الإيماءات

    هيكل اليد مباشرة، والإيماءة الخام والمؤكدة، والدرجات، واليد المستخدمة، واتجاه الكف، وعدد الإطارات — لضبط الحساسية على أي جهاز.

05الشاشات

لا توجد لقطات لهذا المشروع بعد، لذا يُعرض من خلال معماريته بدل شاشات مختلقة.

06معمارية النظام

  1. L1الإدراك
    • CameraX
    • MediaPipe HandLandmarker
    • GestureEngine
  2. L2التدفق
    • Send VM
    • Receive VM
    • Fist → grab
    • Palm 700 ms → accept
  3. L3النقل
    • SendController + reducer
    • ReceiveController + reducer
    • Nearby BYTES + FILE
  4. L4التخزين
    • MediaStore
    • SHA-256 verify
    • Room history
الكاميرا ← المتتبع ← محرك الإيماءات ← نماذج الإرسال والاستقبال ← متحكمات ومخفِّضات نقية ↔ Nearby ← MediaStore مع SHA-256.مخطط — مستخلص من الكود المصدري

07تحديات تقنية

  1. الكف نجح في المختبر لا على هاتف حقيقي

    كشف الاختبار الميداني على OPPO Reno13 F (أندرويد ١٦) ثلاثة أسباب: إقلاع الكاميرا البارد ١–١.٥ ثانية داخل نافذة ٥ ثوانٍ، وانتهاء أذونات الكاميرا «لهذه المرة فقط» بصمت على ColorOS، وفحص اتجاه الكف الذي يرفض اليد المائلة. الآن يسخّن المستقبل الكاميرا فور الاقتران، والنافذة ٧ ثوانٍ، وفحص الاتجاه مطفأ افتراضياً.

08دروس مستفادة

قِس على أضعف هاتف تجده؛ فهو من يحدد السقف.

مساهمتي

التصميم ومحرك الإيماءات وبروتوكول النقل والاختبار الميداني — ١٥ إيداعاً.

التقنيات

  • Kotlin
  • Jetpack Compose
  • Material 3
  • CameraX
  • MediaPipe
  • Nearby Connections
  • Hilt
  • Room
  • DataStore
  • Coroutines
  • Flow
  • kotlinx.serialization
  • MockK
  • Turbine
  • Computer Vision

كيف تم التحقق

تمت مراجعة الكود والوثائق والبروتوكول وسجل القرارات، بما فيها ملاحظات الاختبار الميداني وقياسات السرعة. اللقطات ما زالت مؤجلة في المشروع، لذا لا تُعرض.

مشاريع ذات صلة

المشروع التالي

SUBZERO