امکانات‌ دیگر ویرایش

چابک متناسب با نیاز شما امکانات دیگری را هم در اختیار شما می گذارد. در این صفحه می‌توانید از وضعیت اتصال سرور و کلاینت مطلع شوید. شناسه‌های دستگاه و کاربر خود را از چابک دریافت نمایید. همچنین نشان‌هایی (Badge) که روی آیکون اپ شما در دستگاه کاربر نمایش داده می‌شود را می‌توانید کنترل کنید. در آخر می‌توانید از وضعیت اپ خود (فورگراند و بک‌گراند بودن آن) آگاه شوید.

دریافت شناسه دستگاه

چابک هر دستگاه کاربر را به صورت خودکار پس از ثبت با یک شناسه منحصر به فرد در سرور خود ذخیره می‌کند. با فراخوانی متد getInstallationId می‌توانید شناسه دستگاه کاربر را دریافت کنید:

AdpPushClient.get().getInstallationId();

دریافت شناسه کاربر

چابک شناسه کاربر را پس از ثبت به صورت رمزنگاری شده در حافظه دستگاه ذخیره می‌کند. توصیه می‌شود از ذخیره‌سازی این شناسه خودداری کنید و با استفاده از متد getUserId شناسه کاربر را دریافت کنید:

AdpPushClient.get().getUserId();

مدیریت نشان‌ها (Badge)

بسته به نوع اپلیکیشنی که دارید، بازنشانی badge معنای متفاوتی پیدا می‌کند. به عنوان مثال اگر اپلیکیشن پیام‌رسانی و چت دارید آن موقع، بازنشانی پس از خواندن پیام معنا دارد. در غیر این صورت معمولا بازنشانی پس از فقط باز کردن اپلیکیشن انجام می‌شود.

اگر می‌خواهید شماره badge برنامه خود را بازنشانی کنید، با روش زیر می‌توانید:

AdpPushClient.get().resetBadge();

غیرفعال‌سازی مدیریت خودکار

چابک به صورت خودکار اقدام به پاک کردن نوتیفیکیشن‌ها و نشانه‌ها به هنگام باز شدن اپلیکیشن می‌کند. برای غیرفعال‌سازی این قابلیت از متد setAutoResetBadge استفاده نمایید.

` نکته: مقدار پیش‌فرض این متد true است، بنابراین اگر مقدار false را قرار دهید برای پاک کردن دستی **Badge** و نوتیفیکیشن [باید متد resetBadge` را فراخوانی کنید.](/android/features.html#مدیریت-نشانها-badge)

برداشتن مجوز‌های غیر ضروری برای نمایش نشان (Badge) روی آیکون

با توجه به حجم زیاد این مجوزها امکان دارد کاربر نسبت به این دسترسی‌های غیر ضروری حس منفی پیدا کند، برای همین می‌توانید با استفاده از دستور‌های زیر هر کدام آن‌ها را با اختیار خود بردارید:

<uses-permission android:name="com.sec.android.provider.badge.permission.READ" tools:node="remove" />
<uses-permission android:name="com.sec.android.provider.badge.permission.WRITE" tools:node="remove" />
<uses-permission android:name="com.htc.launcher.permission.READ_SETTINGS" tools:node="remove" />
<uses-permission android:name="com.htc.launcher.permission.UPDATE_SHORTCUT" tools:node="remove" />
<uses-permission android:name="com.sonyericsson.home.permission.BROADCAST_BADGE" tools:node="remove" />
<uses-permission android:name="com.sonymobile.home.permission.PROVIDER_INSERT_BADGE" tools:node="remove" />
<uses-permission android:name="com.anddoes.launcher.permission.UPDATE_COUNT" tools:node="remove" />
<uses-permission android:name="com.majeur.launcher.permission.UPDATE_BADGE" tools:node="remove" />
<uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE" tools:node="remove"/>
<uses-permission android:name="com.huawei.android.launcher.permission.READ_SETTINGS" tools:node="remove" />
<uses-permission android:name="com.huawei.android.launcher.permission.WRITE_SETTINGS" tools:node="remove" />
<uses-permission android:name="android.permission.READ_APP_BADGE" tools:node="remove" />
<uses-permission android:name="com.oppo.launcher.permission.READ_SETTINGS" tools:node="remove" />
<uses-permission android:name="com.oppo.launcher.permission.WRITE_SETTINGS" tools:node="remove" />
<uses-permission android:name="me.everything.badger.permission.BADGE_COUNT_READ" tools:node="remove" />
<uses-permission android:name="me.everything.badger.permission.BADGE_COUNT_WRITE" tools:node="remove"/> 

همچنین باید کد زیر را به تگ manifest در بالای فایل اضافه کنید.

xmlns:tools="http://schemas.android.com/tools"

نمونه اضافه کد به فایل manifest:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:tools="http://schemas.android.com/tools"
          package="com.chabok.example">
          ...
</manifest>

غیرفعالسازی نمایش نشان (Badge) روی آیکون

برای غیرفعالسازی نمایش Badge برای اعلان‌ها روی آیکون اپلیکیشنتان، کد زیر را به فایل AndroidManifest.xml خود اضافه کنید:

<meta-data android:name="com.adpdigital.push.client.BadgeCount" android:value="DISABLE" />

وضعیت اتصال به چابک

برای دریافت وضعیت اتصال به چابک، می‌توانید از دو روش رویداد onEvent و متد getStatus استفاده کنید.

رویداد وضعیت اتصال

با استفاده از متد onEvent، همانند قطعه کد زیر پیاده‌سازی قادر به دریافت وضعیت اتصال به چابک خواهید بود و با فراخوانی متد addListener، کلاسی را که متد onEvent در آن پیاده‌سازی شده است را به چابک معرفی کنید.

AdpPushClient.get().addListener(this);
public void onEvent(final ConnectionStatus status) {
    switch (status) {
        case CONNECTED:
            Log.d(TAG, "Connected to the chabok");
            break;
        case CONNECTING:
            Log.d(TAG, "Connecting to the chabok");
            break;
        case DISCONNECTED:
            Log.d(TAG, "Disconnected");
            break;
        default:
            Log.d(TAG, "Disconnected");
    }
}

متد وضعیت اتصال

با فراخوانی متد getStatus می‌توانید از وضعیت آخر اتصال به چابک مطلع شوید.

AdpPushClient.get().getStatus(new Callback<ConnectionStatus>() {
    @Override
    public void onSuccess(ConnectionStatus connectionStatus) {
        Log.d(TAG, "Connection status is " + connectionStatus.name());
    }
    @Override
    public void onFailure(Throwable throwable) {
        Log.d(TAG, "Error happend " + throwable.getMessage());
    }
});

نکته: اگر می‌خواهید تغییرات وضعیت اتصال به سرور چابک را در سمت لایه UI نشان دهید، چون ممکن است قبل از اینکه کلاس شما به عنوان listener معرفی شود، ایونت تغییر وضعیت اتصال به شما برسد و شما آن را از دست بدهید، بهتر است برای اولین بار وضعیت اتصال را با استفاده از متد getStatus از چابک دریافت نمایید.

رویداد وضعیت اپلیکیشن

با پیاده‌سازی متد onEvent و معرفی کلاس آن به متد addListener قادر به دریافت وضعیت اپلیکیشنتان (ثبت کاربر، نصب، باز شدن اپلیکیشن و برنامه‌های حفاظت شده) خواهید بود.

AdpPushClient.get().addListener(this);

public void onEvent(AppState state) {
    if (state == AppState.REGISTERED) {
        Log.d(TAG, "User successfully registered...");
    } else if (state == AppState.INSTALL) {
        //This state will call one time.
        Log.d(TAG, "The application installed");
    } else if (state == AppState.LAUNCH) {
        Log.d(TAG, "The application launched");
    } else if (state == AppState.PROTECTED_GRANT_NEEDED) {
        Log.d(TAG, "Protected grant needed");
    }
}

دریافت وضعیت اپلیکیشن

جهت بررسی وضعیت اپلیکیشن خود در حال اجرا (Background یا Foreground) می‌توانید متد‌های زیر را فراخوانی کنید:

//App is in background.
AdpPushClient.get().isBackground();

//App is in foreground.
AdpPushClient.get().isForeground();

تغییر نام پیش‌فرض کانال نوتیفیکیشن (مخصوص اندروید ۸ به بالا)

اندروید در نسخه‌های ۸ به بالا از کانال نوتیفیکیشن استفاده می‌کند. به این صورت که کاربر در تنظیمات اپلیکیشن می‌تواند این کانال‌ها را مشاهده و یا آن‌ها را غیر فعال کند. شما می‌توانید با متد زیر نام این کانال را به دلخواهتان تغییر دهید:

AdpPushClient.get().setDefaultNotificationChannel(“Personal Alert”);