اتصال API

هشدار: برای برنامه‌هایی که از CarConnection API استفاده می‌کنند و اندروید ۱۴ (سطح API ۳۴) و بالاتر را هدف قرار می‌دهند ، از Car App Library نسخه 1.3.0-beta01 یا بالاتر استفاده کنید. نسخه‌های قبلی این کتابخانه به دلیل الزام گیرنده‌های ثبت‌شده در متن برای مشخص کردن رفتار خروجی ، در دستگاه‌هایی که اندروید ۱۴ یا بالاتر دارند، استثنا ایجاد می‌کنند.

صرف نظر از نسخه کتابخانه برنامه خودرو، برای برنامه‌هایی که اندروید ۱۳ (سطح API ۳۳) یا پایین‌تر را هدف قرار می‌دهند، CarConnection API با این مشکل مواجه نمی‌شود، حتی در دستگاهی که اندروید ۱۴ یا بالاتر دارد.

برای تعیین اینکه آیا برنامه شما روی Android Auto یا Android Automotive OS اجرا می‌شود، از CarConnection API برای بازیابی اطلاعات اتصال در زمان اجرا استفاده کنید. به عنوان مثال:

1. در Session برنامه ماشین خود، یک CarConnection راه‌اندازی کنید و در به‌روزرسانی‌های LiveData مشترک شوید:

CarConnection(carContext).type.observe(this, ::onConnectionStateUpdated)
ConnectionApi.kt

1. در ناظر، به تغییرات در وضعیت اتصال واکنش نشان دهید:

fun onConnectionStateUpdated(connectionState: Int) {
    val message = when (connectionState) {
        CarConnection.CONNECTION_TYPE_NOT_CONNECTED -> "Not connected to a head unit"
        CarConnection.CONNECTION_TYPE_NATIVE -> "Connected to Android Automotive OS"
        CarConnection.CONNECTION_TYPE_PROJECTION -> "Connected to Android Auto"
        else -> "Unknown car connection type"
    }
    CarToast.makeText(carContext, message, CarToast.LENGTH_SHORT).show()
}
ConnectionApi.kt