الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
الخلاصة

  • location.get هو أمر عقدة (عبر node.invoke).
  • معطّل افتراضيًا.
  • تستخدم إعدادات تطبيق Android محددًا: إيقاف / أثناء الاستخدام.
  • مفتاح تبديل منفصل: الموقع الدقيق.

​
لماذا محدد (وليس مجرد مفتاح تبديل)

أذونات نظام التشغيل متعددة المستويات. يمكننا عرض محدد داخل التطبيق، لكن نظام التشغيل يظل هو من يقرر المنح الفعلي.
  • قد يعرض iOS/macOS خيار أثناء الاستخدام أو دائمًا في مطالبات/إعدادات النظام.
  • يدعم تطبيق Android حاليًا موقع الواجهة الأمامية فقط.
  • الموقع الدقيق هو منح منفصل (iOS 14+ “دقيق”، وAndroid “fine” مقابل “coarse”).
يقود المحدد في واجهة المستخدم الوضع المطلوب من جانبنا؛ أما المنح الفعلي فيوجد في إعدادات نظام التشغيل.

​
نموذج الإعدادات

لكل جهاز عقدة:
  • location.enabledMode: off | whileUsing
  • location.preciseEnabled: bool
سلوك واجهة المستخدم:
  • يؤدي تحديد whileUsing إلى طلب إذن الواجهة الأمامية.
  • إذا رفض نظام التشغيل المستوى المطلوب، فارجع إلى أعلى مستوى ممنوح واعرض الحالة.

​
تعيين الأذونات (node.permissions)

اختياري. تبلّغ عقدة macOS عن location عبر خريطة الأذونات؛ وقد يحذفه iOS/Android.

​
الأمر: location.get

يُستدعى عبر node.invoke. المعلمات (مقترحة): 
{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}
حمولة الاستجابة: 
{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}
الأخطاء (رموز مستقرة):
  • LOCATION_DISABLED: المحدد في وضع الإيقاف.
  • LOCATION_PERMISSION_REQUIRED: الإذن مفقود للوضع المطلوب.
  • LOCATION_BACKGROUND_UNAVAILABLE: التطبيق في الخلفية لكن المسموح به هو أثناء الاستخدام فقط.
  • LOCATION_TIMEOUT: لم يتم الحصول على تحديد في الوقت المحدد.
  • LOCATION_UNAVAILABLE: فشل في النظام / لا توجد موفّرات.

​
سلوك الخلفية

  • يرفض تطبيق Android الأمر location.get أثناء وجوده في الخلفية.
  • أبقِ OpenClaw مفتوحًا عند طلب الموقع على Android.
  • قد تختلف منصات العقد الأخرى.

​
تكامل النماذج/الأدوات

  • سطح الأداة: تضيف أداة nodes إجراء location_get (العقدة مطلوبة).
  • CLI: openclaw nodes location get --node <id>.
  • إرشادات الوكيل: لا تستدعِها إلا عندما يكون المستخدم قد فعّل الموقع ويفهم النطاق.

​
نصوص تجربة المستخدم (مقترحة)

  • إيقاف: “مشاركة الموقع معطلة.”
  • أثناء الاستخدام: “فقط عندما يكون OpenClaw مفتوحًا.”
  • دقيق: “استخدم موقع GPS الدقيق. أوقف التبديل لمشاركة موقع تقريبي.”

​
ذو صلة