Kaffكفّ
اقبض على الملف بيدك، وافتح كفّك أمام الهاتف الآخر — فينتقل. دون إنترنت.
- الحالة
- اكتملت ست مراحل تطوير؛ وأُنجزت الجولة الأولى من الاختبار الميداني على هواتف حقيقية.
- الفترة
- 2026
- المنصات
- Android
- المستودع
- خاص — متاح عند الطلب
- منشور
- —
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
02المشكلة
إرسال ملف بين هاتفين متجاورين ما زال يعني تطبيقات وحسابات وكوابل أو إنترنت. والحركة يجب أن تكون طبيعية كأنك تناول شيئاً بيدك.
03الحل
يغذّي MediaPipe HandLandmarker (المعالج الرسومي مع بديل المعالج) محرّك الإيماءات؛ ومنطق النقل زوج من آلات الحالة النقية للإرسال والاستقبال فوق حمولات Nearby، والحفظ في MediaStore مع فحص السلامة.
04الميزات الرئيسية
- 01
الاقتران قبل أي نقل
يعرض الهاتفان الأرقام الأربعة نفسها، ولا يُقبل شيء حتى يؤكد المستقبل. فالإيماءة مُشغِّل لا وسيلة تحقق من الهوية.
- 02
السلامة
التحقق من SHA-256 والحجم أثناء الحفظ؛ والملفات التالفة لا تظهر في المعرض أبداً. حتى ٢٠ ملفاً في النقل الواحد.
- 03
واعٍ باستهلاك الطاقة
إطفاء الكاميرا تلقائياً، ونحو ١٥ إطاراً/ث في وضع توفير البطارية، وإيقاف مؤقت عند سخونة الهاتف.
- 04
مختبر الإيماءات
هيكل اليد مباشرة، والإيماءة الخام والمؤكدة، والدرجات، واليد المستخدمة، واتجاه الكف، وعدد الإطارات — لضبط الحساسية على أي جهاز.
05الشاشات
لا توجد لقطات لهذا المشروع بعد، لذا يُعرض من خلال معماريته بدل شاشات مختلقة.
06معمارية النظام
- L1الإدراك
- CameraX
- MediaPipe HandLandmarker
- GestureEngine
- L2التدفق
- Send VM
- Receive VM
- Fist → grab
- Palm 700 ms → accept
- L3النقل
- SendController + reducer
- ReceiveController + reducer
- Nearby BYTES + FILE
- L4التخزين
- MediaStore
- SHA-256 verify
- Room history
07تحديات تقنية
الكف نجح في المختبر لا على هاتف حقيقي
كشف الاختبار الميداني على 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
كيف تم التحقق
تمت مراجعة الكود والوثائق والبروتوكول وسجل القرارات، بما فيها ملاحظات الاختبار الميداني وقياسات السرعة. اللقطات ما زالت مؤجلة في المشروع، لذا لا تُعرض.
مشاريع ذات صلة
- A
AirControl Pro
- Kotlin
- Jetpack Compose
- MediaPipe
- CameraX
- Hilt
- Room
- Accessibility Service
- Computer Vision
AirControl Pro
تحكّم بهاتفك بإيماءات اليد في الهواء.
نموذج أوليأندرويدذكاء اصطناعي - Wوصلة
Wasla
- SyncEngine
- UdpDiscovery
- TcpServer
- Framing
- PairingKey
- Room
- Android clipboard bridge
- Desktop clipboard bridge
- Crypto.android
Wasla
وصلةحافظة مشتركة بين الهاتف والحاسوب — Kotlin Multiplatform، من جهاز لجهاز، ومشفّرة.
نموذج أوليأندرويدسطح المكتب 
CodePort
ميناء الكودمستودع GitHub كمدينة ميناء حيّة بمنظور متساوي القياس — كل إيماءة تنفّذ أمر Git حقيقياً.
نموذج أوليأندرويد
المشروع التالي
SUBZERO