البدء

يوضّح هذا المستند طريقة بدء استخدام واجهة برمجة التطبيقات Aware Aware API على أجهزة Android. إنّ واجهة برمجة تطبيقات الوعي هي جزء من خدمات Google Play.

لاستخدام واجهة برمجة تطبيقات الوعي، يجب أن يكون لديك حساب على Google. إذا كان لديك حساب، هذا يعني أنه تم الانتهاء من الإعداد. ننصحك أيضًا بإنشاء حساب منفصل على Google لأغراض الاختبار.

قبل البدء

الحصول على مفتاح واجهة برمجة تطبيقات

إذا لم يسبق لك تفعيل الوعي بواجهة برمجة التطبيقات والحصول على مفتاح Google API، اتّبِع الخطوات الواردة في مفاتيح الاشتراك وواجهة برمجة التطبيقات لتنفيذ ذلك.

إعداد تطبيقك

  1. في ملف build.gradle على مستوى المشروع، أدرِج مستودع Google Maven في كل من قسمَي buildscript وallprojects:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. أضِف ارتباطات واجهة برمجة تطبيقات الوعي إلى ملف Grall على مستوى التطبيق، والذي يكون عادةً app/build.gradle:

    dependencies {
  implementation 'com.google.android.gms:play-services-awareness:19.0.1'
}

  3. أضِف مفتاح واجهة برمجة التطبيقات لزيادة الوعي إلى ملف AndroidManifest.xml لتطبيقك. ولإجراء ذلك، أضِف علامة <meta-data> باستخدام android:name="com.google.android.awareness.API_KEY". بالنسبة إلى android:value، أدخِل مفتاح واجهة برمجة تطبيقات الوعي الخاص بك، ويكون محاطًا بعلامتَي اقتباس.

    <manifest>
    <application>
        <meta-data
            android:name="com.google.android.awareness.API_KEY"
            android:value="API_KEY"/>
    </application>
</manifest>

  4. أضِف الأذونات اللازمة إلى ملف AndroidManifest.xml لتطبيقك. وتختلف الأذونات المطلوبة بناءً على طرق واجهة برمجة التطبيقات وأنواع السياج التي يستخدمها تطبيقك.

مثال على مكالمة

يوضح المثال التالي لاستدعاء getDetectedActivity() كيفية استخدام نموذج خدمات Google Play غير المتصل مع Awareness API:

    // Each type of contextual information in the snapshot API has a corresponding "get" method.
    // For instance, this is how to get the user's current Activity.
    Awareness.getSnapshotClient(this).getDetectedActivity()
        .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
            @Override
            public void onSuccess(DetectedActivityResponse dar) {
                ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                // getMostProbableActivity() is good enough for basic Activity detection.
                // To work within a threshold of confidence,
                // use ActivityRecognitionResult.getProbableActivities() to get a list of
                // potential current activities, and check the confidence of each one.
                DetectedActivity probableActivity = arr.getMostProbableActivity();

                int confidence = probableActivity.getConfidence();
                String activityStr = probableActivity.toString();
                mLogFragment.getLogView().println("Activity: " + activityStr
                    + ", Confidence: " + confidence + "/100");
            }
        })

الخطوات التالية

اطّلِع على مزيد من المعلومات عن واجهات برمجة التطبيقات المختلفة ضمن واجهة برمجة تطبيقات الوعي: