Android

يفتح زر المساعدة لديك نافذة أصلية. إن كان للتطبيق مقالات مساعدة، يجيب المساعد منها. وإلا، أو حين يطلب المستخدم، يفتح نموذج التواصل: يكتب المستخدم، ويرى لقطة للشاشة التي كان عليها، ويخفي أو يزيل ما يشاء، ثم يضغط إرسال. تعمل في تطبيقات Views وCompose، وminSdk 26.

التثبيت

لم تُنشر بعد

المكتبة غير منشورة على Maven بعد: تصلك مع حسابك، وحدةً تضيفها إلى بناء Gradle.

الاستعمال

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        AppSupport.configure(this, AppSupportOptions(
            appKey = "pk_…",                        // تطبيقات الدعم ← المفاتيح (عام)
            apiUrl = "https://<your support host>",
            appVersion = BuildConfig.VERSION_NAME,
        ))
    }
}

// زر المساعدة الخاص بك، في أي Activity:
helpButton.setOnClickListener { AppSupport.open(this) }

• علّم ما يجب ألا يغادر الجهاز أبدًا: Modifier.supportMask() في Compose، وAppSupport.mask(view) لـ View (أرقام البطاقات، والأرصدة، والبيانات الشخصية). وتُحجب أيضًا حقول كلمات المرور وWebView وSurfaceView وTextureView (الخرائط والفيديو) قبل أن يرى المستخدم المعاينة.
• تتبع اللغة AppSupportOptions.language، ثم لغة التطبيق (ar أو en)، ثم لغته الأولى. والعربية من اليمين إلى اليسار بالكامل.
• تعلن المكتبة إذن INTERNET، ويندمج SupportActivity الخاص بها في ملف manifest لديك.

ما تفعله، وما لا تفعله أبدًا

• لا تفتح نفسها أبدًا ولا ترمي أي خطأ في تطبيقك. يعود open() فورًا، وتذهب المشكلات إلى Logcat (الوسم support). والضغطة الثانية أثناء الفتح أو والدعم مفتوح لا تفعل شيئًا. وAppSupport.close() يغلقه.
• صورة ثابتة واحدة لتطبيقك، تُلتقط بـ PixelCopy لنافذة النشاط لحظة فتح الدعم، قبل رسم النافذة. لا تحتاج إذنًا ولا تُظهر طلبًا من النظام. ولا تُظهر أبدًا التطبيقات الأخرى أو شريط الحالة أو لوحة المفاتيح أو حواراتك. ويستطيع المستخدم إخفاء أجزاء (تُحرق في البكسلات)، أو إزالتها، أو إرفاقها. وما تعرضه المعاينة هو تمامًا ما يُرفع.
• الصورة في الذاكرة فقط. لا تُكتب على القرص ولا تمر عبر Intent أبدًا. وحين تتعذّر الخدمة، تُحفظ الرسالة (نصًا فقط) في طابور: 5 رسائل على الأكثر، لمدة تصل إلى 3 أيام، تُرسل عند configure() أو open() التالي، أو حين يعود التطبيق إلى الواجهة. ويخبر النموذج المستخدم بأن الرسالة ستُرسل دون اللقطة.
• المساعد لا يجيب إلا من مقالاتك ويسمّي ما استعمله. وحين لا يستطيع الإجابة يقول ذلك، و«لم يفِد؟» ينقل المستخدم إلى النموذج مع المحادثة مرفقة، ويستطيع المستخدم إلغاء إرفاقها.
• لا يُرسل إلا السياق المسموح به: إصدار التطبيق، وبنيته، واسم نظام التشغيل وإصداره الرئيسي، وهل الجهاز هاتف أو لوحي، واللغة. ويسرده النموذج تحت الرسالة.
• يُستعمل معرّف تثبيت عشوائي لحدود المعدّل فقط.
• تنطبق ألوان تطبيق الدعم وشعاره. أما خطّه فلا: لا يستطيع تطبيق Android تحميل خط باسم عائلته.

سياسة الخصوصية لديك: نموذج

حين تتواصل مع الدعم في هذا التطبيق، نرسل رسالتك، وإن أبقيتهما مرفقتين، لقطة للشاشة التي كنت عليها ومحادثتك مع مساعد المساعدة. ونرسل أيضًا إصدار التطبيق ونظام التشغيل ونوع الجهاز. وترى كل ذلك قبل أن تضغط إرسال. وتُحفظ رسائل الدعم 180 يومًا بعد حلّها.