Arabalar için Android Uygulama Kitaplığı'nı kullanma

Arabalar için Android Uygulama Kitaplığı, navigasyon, önemli yer (ÖY) ve nesnelerin interneti (IoT) uygulamalarınızı araca getirmenize olanak tanır. Bunu, sürücü dikkat dağıtma standartlarını karşılamak için tasarlanmış bir dizi şablon sağlayarak ve araç ekranı faktörlerinin çeşitliliği ve giriş modları gibi ayrıntılara dikkat ederek yapar.

Bu kılavuzda, kitaplığın temel özelliklerine ve kavramlarına genel bir bakış sunulmakta ve temel bir uygulama oluşturma sürecinde size yol gösterilmektedir.

Codelab

Araç Uygulama Kitaplığı'nın temellerini öğrenme

arrow_forward

Başlamadan önce

1. Araba Uygulama Kitaplığı'nı kapsayan Araç Kullanırken Tasarım sayfalarını inceleyin
   • Navigasyon uygulamaları ve Araç kullanmayla ilgili diğer uygulamalar kategorilerine genel bakış
   • Şablonlarla uygulama oluşturma'ya genel bakış
   • Şablonlar ve Şablon bileşenlerini kapsayan yapı taşları
   • Sık karşılaşılan kullanıcı deneyimi kalıplarını gösteren örnek akışlar
   • Şablonlu uygulama şartları
2. Aşağıdaki bölümde temel terimleri ve kavramları inceleyin.
3. Android Auto sistem kullanıcı arayüzü ve Android Automotive OS tasarımı hakkında bilgi edinin.
4. Sürüm notlarını inceleyin.
5. Örnekleri inceleyin.

Temel terimler ve kavramlar

Modeller ve Şablonlar

Kullanıcı arayüzü, ait oldukları şablonun izin verdiği şekilde farklı şekillerde birlikte düzenlenebilen model nesnelerinin grafiğiyle temsil edilir. Şablonlar, bu grafiklerde kök görevi görebilecek modellerin bir alt kümesidir. Modeller, kullanıcıya metin ve resim biçiminde gösterilecek bilgilerin yanı sıra bu bilgilerin görsel görünümünün özelliklerini (ör. metin renkleri veya resim boyutları) yapılandırmaya yönelik özellikleri içerir. Barındıran, modelleri sürücü dikkat dağıtma standartlarını karşılayacak şekilde tasarlanmış görünümlere dönüştürür ve araç ekranı faktörlerinin çeşitliliği ve giriş modları gibi ayrıntılarla ilgilenir.

Düzenleyen

Barındırıcı, uygulamanızın araçta çalışabilmesi için kitaplığın API'leri tarafından sunulan işlevleri uygulayan arka uç bileşenidir. Barındırıcının sorumlulukları, uygulamanızı keşfetme ve yaşam döngüsünü yönetmenin yanı sıra modellerinizi görünümlere dönüştürme ve uygulamanızı kullanıcı etkileşimlerinden haberdar etme gibi çeşitli işlemleri kapsar. Mobil cihazlarda bu ana makine Android Auto tarafından uygulanır. Android Automotive OS'te bu ana makine sistem uygulaması olarak yüklenir.

Şablon kısıtlamaları

Farklı şablonlar, modellerinin içeriğinde kısıtlamalar uygular. Örneğin, liste şablonlarında kullanıcıya gösterilebilecek öğe sayısıyla ilgili sınırlamalar vardır. Şablonların, bir görevin akışını oluşturmak için bağlanma şekliyle ilgili kısıtlamaları da vardır. Örneğin, uygulama ekran yığınına yalnızca beş şablon gönderebilir. Daha fazla bilgi için Şablon kısıtlamaları bölümüne bakın.

Screen

Screen, kitaplık tarafından sağlanan ve uygulamalar tarafından kullanıcıya sunulan kullanıcı arayüzünü yönetmek için uygulanan bir sınıftır. Screen, yaşam döngüsü olan ve uygulamanın ekran görünür olduğunda şablonu göndermesi için mekanizma sağlayan bir öğedir. Screen örnekleri, şablon akışı kısıtlamalarına uymalarını sağlamak için bir Screen yığınına itilebilir ve yığından çıkarılabilir.

CarAppService

CarAppService, barındırıcı tarafından keşfedilip yönetilebilmesi için uygulamanızın uygulamasını ve dışa aktarmasını gerektiren soyut bir Service sınıfıdır. Uygulamanızın CarAppService, createHostValidator kullanarak bir ana makine bağlantısının güvenilir olup olmadığını doğrulamaktan ve ardından onCreateSession kullanarak her bağlantı için Session örnekleri sağlamaktan sorumludur.

Session

Session, uygulamanızın CarAppService.onCreateSession kullanarak uygulamak ve döndürmek zorunda olduğu soyut bir sınıftır. Araba ekranında bilgi görüntülemek için giriş noktası olarak kullanılır. Uygulamanızın araba ekranındaki mevcut durumunu (ör. uygulamanızın görünür veya gizli olduğu durumlar) bildiren bir yaşam döngüsü vardır.

Bir Session başlatıldığında (ör. uygulama ilk kez başlatıldığında) ana makine, onCreateScreen yöntemini kullanarak ilk Screen'ın gösterilmesini ister.

Araba Uygulama Kitaplığı'nı yükleme

Kitaplığı uygulamanıza eklemeyle ilgili talimatlar için Jetpack kitaplığı sürüm sayfasına bakın.

Uygulamanızın manifest dosyalarını yapılandırma

Araba uygulamanızı oluşturmadan önce uygulamanızın manifest dosyalarını aşağıdaki gibi yapılandırın.

CarAppService'inizi beyan etme

Barındırıcı, CarAppService uygulamanız aracılığıyla uygulamanıza bağlanır. Ana makinenin uygulamanızı keşfetmesine ve uygulamanıza bağlanmasına izin vermek için bu hizmeti manifest dosyanızda belirtirsiniz.

Ayrıca, uygulamanızın intent filtresinin <category> öğesinde uygulamanızın kategorisini de belirtmeniz gerekir. Bu öğe için izin verilen değerlere ilişkin desteklenen uygulama kategorilerinin listesine bakın.

Aşağıdaki kod snippet'inde, manifest dosyanızda bir ilgi çekici yer uygulaması için araba uygulaması hizmetinin nasıl tanımlanacağı gösterilmektedir:

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService"/>
        <category android:name="androidx.car.app.category.POI"/>
      </intent-filter>
    </service>

    ...
<application>

Desteklenen uygulama kategorileri

Önceki bölümde açıklandığı şekilde CarAppService değerinizi beyan ederken intent filtresine aşağıdaki kategori değerlerinden birini veya daha fazlasını ekleyerek uygulamanızın kategorisini beyan edin:

• androidx.car.app.category.NAVIGATION: Adım adım yol tarifleri sunan bir uygulama. Arabalar için navigasyon uygulamaları oluşturma başlıklı makaleyi inceleyin.
• androidx.car.app.category.POI: Park yerleri, şarj istasyonları ve benzin istasyonları gibi ilgi çekici yerleri bulmayla ilgili işlevler sunan bir uygulama. Araçlarla ilgili önemli yer uygulamaları oluşturma başlıklı makaleyi inceleyin.
• androidx.car.app.category.IOT: Kullanıcıların, bağlı cihazlarda arabadan ilgili işlemleri yapmasını sağlayan bir uygulama. Arabalar için internet of things uygulamaları oluşturma başlıklı makaleyi inceleyin.
• androidx.car.app.category.WEATHER: Kullanıcıların mevcut konumlarıyla veya rotalarıyla ilgili alakalı hava durumu bilgilerini görmelerini sağlayan bir uygulama. Arabalar için hava durumu uygulamaları oluşturma başlıklı makaleyi inceleyin.

Her kategorinin ayrıntılı açıklamaları ve uygulamaların bu kategorilere ait olma ölçütleri için Arabalar için Android uygulama kalitesi başlıklı makaleyi inceleyin.

Uygulama adını ve simgesini belirtin

Ana makinenin, uygulamanızı sistem kullanıcı arayüzünde temsil etmek için kullanabileceği bir uygulama adı ve simgesi belirtmeniz gerekir.

CarAppService öğenizin label ve icon özelliklerini kullanarak uygulamanızı temsil etmek için kullanılan uygulama adını ve simgesini belirtebilirsiniz:

...
<service
   android:name=".MyCarAppService"
   android:exported="true"
   android:label="@string/my_app_name"
   android:icon="@drawable/my_app_icon">
   ...
</service>
...

Etiket veya simge <service> öğesinde tanımlanmazsa ana makine, <application> öğesi için belirtilen değerlere geri döner.

Özel tema ayarlama

Araba uygulamanız için özel bir tema ayarlamak istiyorsanız aşağıdaki gibi manifest dosyanıza bir <meta-data> öğesi ekleyin:

<meta-data
    android:name="androidx.car.app.theme"
    android:resource="@style/MyCarAppTheme />

Ardından, özel araç uygulama temanız için aşağıdaki özellikleri ayarlamak üzere stil kaynağınızı tanımlayın:

<resources>
  <style name="MyCarAppTheme">
    <item name="carColorPrimary">@layout/my_primary_car_color</item>
    <item name="carColorPrimaryDark">@layout/my_primary_dark_car_color</item>
    <item name="carColorSecondary">@layout/my_secondary_car_color</item>
    <item name="carColorSecondaryDark">@layout/my_secondary_dark_car_color</item>
    <item name="carPermissionActivityLayout">@layout/my_custom_background</item>
  </style>
</resources>

Araba uygulaması API düzeyi

Araç Uygulama Kitaplığı, bir araçtaki şablon ana makinesinin hangi kitaplık özelliklerini desteklediğini bilmeniz için kendi API düzeylerini tanımlar. Bir ana makine tarafından desteklenen en yüksek Car App API düzeyini almak için getCarAppApiLevel() yöntemini kullanın.

Uygulamanızın desteklediği minimum Car App API düzeyini AndroidManifest.xml dosyanızda belirtin:

<manifest ...>
    <application ...>
        <meta-data
            android:name="androidx.car.app.minCarApiLevel"
            android:value="1"/>
    </application>
</manifest>

Geriye dönük uyumluluğu nasıl koruyacağınız ve bir özelliği kullanmak için gereken minimum API düzeyini nasıl beyan edeceğinizle ilgili ayrıntılar için RequiresCarApi ek açıklamalarının dokümanlarına bakın. Araba Uygulama Kitaplığı'nın belirli bir özelliğini kullanmak için hangi API seviyesinin gerekli olduğuna dair bir tanım için CarAppApiLevels referans dokümanlarını inceleyin.

CarAppService ve Oturumunuzu Oluşturma

Uygulamanızın CarAppService sınıfını genişletmesi ve onCreateSession yöntemini uygulaması gerekir. Bu yöntem, barındırıcıya olan mevcut bağlantıya karşılık gelen bir Session örneği döndürür:

class HelloWorldService : CarAppService() {
    ...
    override fun onCreateSession(): Session {
        return HelloWorldSession()
    }
    ...
}

public final class HelloWorldService extends CarAppService {
    ...
    @Override
    @NonNull
    public Session onCreateSession() {
        return new HelloWorldSession();
    }
    ...
}

Session örneği, uygulama ilk kez başlatıldığında kullanmak üzere Screen örneğini döndürmekten sorumludur:

class HelloWorldSession : Session() {
    ...
    override fun onCreateScreen(intent: Intent): Screen {
        return HelloWorldScreen(carContext)
    }
    ...
}

public final class HelloWorldSession extends Session {
    ...
    @Override
    @NonNull
    public Screen onCreateScreen(@NonNull Intent intent) {
        return new HelloWorldScreen(getCarContext());
    }
    ...
}

Araba uygulamanızın, uygulamanızın ana ekranı veya açılış ekranı olmayan bir ekrandan başlatılması gereken senaryoları (ör. derin bağlantıları işleme) yönetmek için onCreateScreen'ten dönmeden önce ScreenManager.push kullanarak bir arka ekran yığınını önceden ekleyebiliriz. Önceden eklenen veriler, kullanıcıların uygulamanızın gösterdiği ilk ekrandan önceki ekranlara geri dönmelerine olanak tanır.

Başlangıç ekranınızı oluşturma

Screen sınıfını genişleten sınıflar tanımlayarak ve onGetTemplate yöntemini uygulayarak uygulamanızın gösterdiği ekranları oluşturursunuz. Bu yöntem, araç ekranında gösterilecek kullanıcı arayüzünün durumunu temsil eden Template örneğini döndürür.

Aşağıdaki snippet'te, basit bir "Merhaba dünya!" dizesini görüntülemek için PaneTemplate şablonunu kullanan bir Screen öğesinin nasıl tanımlanacağı gösterilmektedir:

class HelloWorldScreen(carContext: CarContext) : Screen(carContext) {
    override fun onGetTemplate(): Template {
        val row = Row.Builder().setTitle("Hello world!").build()
        val pane = Pane.Builder().addRow(row).build()
        return PaneTemplate.Builder(pane)
            .setHeaderAction(Action.APP_ICON)
            .build()
    }
}

public class HelloWorldScreen extends Screen {
    @NonNull
    @Override
    public Template onGetTemplate() {
        Row row = new Row.Builder().setTitle("Hello world!").build();
        Pane pane = new Pane.Builder().addRow(row).build();
        return new PaneTemplate.Builder(pane)
            .setHeaderAction(Action.APP_ICON)
            .build();
    }
}

CarContext sınıfı

CarContext sınıfı, Session ve Screen örneklerinizin erişebildiği bir ContextWrapper alt sınıfıdır. Ekran yığınını yönetmek için ScreenManager, harita çizmek için Surface nesnesine erişme gibi genel uygulama işlevleri için AppManager ve navigasyon meta verilerini ve navigasyonla ilgili diğer etkinlikleri ana makineyle paylaşmak için adım adım navigasyon uygulamaları tarafından kullanılan NavigationManager gibi araç hizmetlerine erişim sağlar.

Gezinme uygulamalarının kullanabileceği kitaplık işlevlerinin kapsamlı bir listesi için Gezinme şablonlarına erişme başlıklı makaleyi inceleyin.

CarContext, araba ekranındaki yapılandırmayı kullanarak çizilebilir kaynakları yüklemenize, intent'leri kullanarak arabanızda bir uygulamayı başlatmanıza ve uygulamanızın haritasını koyu temada göstermesi gerekip gerekmediğini belirtmenize olanak tanır.

Ekran gezinme özelliğini uygulama

Uygulamalar genellikle birkaç farklı ekran sunar. Bu ekranların her biri, kullanıcının ekranda gösterilen arayüzle etkileşime geçerken gezinebileceği farklı şablonlar kullanabilir.

ScreenManager sınıfı, kullanıcı araba ekranında bir geri düğmesi seçtiğinde veya bazı arabalarda bulunan donanım geri düğmesini kullandığında otomatik olarak açılabilen ekranları itmek için kullanabileceğiniz bir ekran yığını sağlar.

Aşağıdaki snippet'te, bir mesaj şablonuna geri düğmesi ve kullanıcı tarafından seçildiğinde yeni bir ekran gösteren bir işlem ekleme gösterilmektedir:

val template = MessageTemplate.Builder("Hello world!")
    .setHeaderAction(Action.BACK)
    .addAction(
        Action.Builder()
            .setTitle("Next screen")
            .setOnClickListener { screenManager.push(NextScreen(carContext)) }
            .build())
    .build()

MessageTemplate template = new MessageTemplate.Builder("Hello world!")
    .setHeaderAction(Action.BACK)
    .addAction(
        new Action.Builder()
            .setTitle("Next screen")
            .setOnClickListener(
                () -> getScreenManager().push(new NextScreen(getCarContext())))
            .build())
    .build();

Action.BACK nesnesi, ScreenManager.pop'ı otomatik olarak çağıran standart bir Action'tir. Bu davranış, CarContext'da bulunan OnBackPressedDispatcher örneği kullanılarak geçersiz kılınabilir.

Uygulamanın sürüş sırasında güvenli bir şekilde kullanılabilmesi için ekran yığınının en fazla beş ekran derinliğinde olması gerekir. Daha fazla bilgi için Şablon kısıtlamaları bölümüne bakın.

Şablon içeriğini yenileme

Uygulamanız, Screen.invalidate yöntemini çağırarak bir Screen içeriğinin geçersiz kılınmasını isteyebilir. Ardından barındırıcı, yeni içeriklerin bulunduğu şablonu almak için uygulamanızın Screen.onGetTemplate yöntemini tekrar çağırır.

Bir Screen'ü yenilerken, barındırıcının yeni şablonu şablon kotasına dahil etmemesi için şablondaki güncellenebilen içeriği anlamak önemlidir. Daha fazla bilgi için Şablon kısıtlamaları bölümüne bakın.

Ekranlarınızı, Screen ile onGetTemplate uygulaması aracılığıyla döndürdüğü şablon türü arasında bire bir eşleme olacak şekilde yapılandırmanızı öneririz.

Harita çizme

Aşağıdaki şablonları kullanan navigasyon ve önemli yer (ÖY) uygulamaları, Surface'a erişerek harita çizebilir:

Yüzey iznini beyan etme

Uygulamanızın kullandığı şablon için gereken izne ek olarak, uygulamanızın yüzeye erişmek için AndroidManifest.xml dosyasında androidx.car.app.ACCESS_SURFACE iznini beyan etmesi gerekir:

<manifest ...>
  ...
  <uses-permission android:name="androidx.car.app.ACCESS_SURFACE" />
  ...
</manifest>

Yüzeylere erişme

Barındırıcının sağladığı Surface'e erişmek için bir SurfaceCallback uygulamanız ve bu uygulamayı AppManager araba hizmetine sağlamanız gerekir. Mevcut Surface, onSurfaceAvailable() ve onSurfaceDestroyed() geri çağırmalarının SurfaceContainer parametresinde SurfaceCallback'inize iletilir.

carContext.getCarService(AppManager::class.java).setSurfaceCallback(surfaceCallback)

carContext.getCarService(AppManager.class).setSurfaceCallback(surfaceCallback);

Yüzeyin görünür alanını anlama

Ev sahibi, şablonlar için kullanıcı arayüzü öğelerini haritanın üzerine çizebilir. Barındırıcı, SurfaceCallback.onVisibleAreaChanged yöntemini çağırarak yüzeyin engelsiz ve kullanıcı tarafından tamamen görülebileceğini garanti eden alanı iletir. Ayrıca, ev sahibi, değişiklik sayısını en aza indirmek için en küçük dikdörtgenle SurfaceCallback.onStableAreaChanged yöntemini çağırır. Bu yöntem, mevcut şablona göre her zaman görünür durumdadır.

Örneğin, bir navigasyon uygulamasında üstte işlem çubuğu bulunan NavigationTemplate kullanılıyorsa kullanıcı ekranla bir süre etkileşimde bulunmadığında haritaya daha fazla yer açmak için işlem çubuğu gizlenebilir. Bu durumda, aynı dikdörtgenle onStableAreaChanged ve onVisibleAreaChanged için geri çağırma işlevi vardır. İşlem çubuğu gizliyken yalnızca onVisibleAreaChanged çağrılır ve daha büyük alan gösterilir. Kullanıcı ekranla etkileşimde bulunursa yine yalnızca ilk dikdörtgenle birlikte onVisibleAreaChanged çağrılır.

Koyu temayı destekleme

Arabalar için Android uygulama kalitesi bölümünde açıklandığı gibi, barındırıcı koşulların bunu gerektirdiğini belirlediğinde uygulamalar, haritalarını Surface örneğinde uygun koyu renklerle yeniden çizmelidir.

Koyu renkli bir harita çizip çizmeyeceğinize karar vermek için CarContext.isDarkMode yöntemini kullanabilirsiniz. Koyu tema durumu her değiştiğinde Session.onCarConfigurationChanged adresine çağrı alırsınız.

Kullanıcıların haritanızla etkileşim kurmasına izin verme

Aşağıdaki şablonları kullanırken kullanıcıların çizdiğiniz haritalarla etkileşime geçmesi için destek ekleyebilirsiniz. Örneğin, yakınlaştırıp uzaklaştırarak haritanın farklı bölümlerini görmelerine olanak tanıyabilirsiniz.

Etkileşimli geri çağırma işlevlerini uygulama

SurfaceCallback arayüzünde, önceki bölümdeki şablonlarla oluşturulan haritalara etkileşim eklemek için uygulayabileceğiniz birkaç geri çağırma yöntemi vardır:

Harita işlem şeridini ekleme

Bu şablonlarda, yakınlaştırma ve uzaklaştırma, yeniden merkezleme, pusula gösterme gibi haritalarla ilgili işlemler ve göstermeyi seçtiğiniz diğer işlemler için bir harita işlem şeridinin bulunabileceği Harita işlem şeridinde, görev derinliğini etkilemeden yenilenebilen en fazla dört adet yalnızca simge düğmesi bulunabilir. Boş durumdayken gizlenir ve etkin durumdayken tekrar görünür.

Harita etkileşimli geri çağırma almak için harita işlem şeridine bir Action.PAN düğmesi eklemeniz gerekir. Kullanıcı kaydırma düğmesine bastığında, aşağıdaki bölümde açıklandığı gibi ev sahibi kaydırma moduna girer.

Uygulamanız, harita işlem şeridindeki Action.PAN düğmesini atlarsa SurfaceCallback yöntemlerinden kullanıcı girişi almaz ve ev sahibi daha önce etkinleştirilmiş tüm kaydırma modlarından çıkar.

Dokunmatik ekranlarda kaydırma düğmesi gösterilmez.

Kaydırma modunu anlama

Kaydırma modunda şablon ana makinesi, dokunmatik olmayan giriş cihazlarından (ör. döner kontrolörler ve dokunmatik yüzeyler) gelen kullanıcı girişlerini uygun SurfaceCallback yöntemlerine dönüştürür. NavigationTemplate.Builder içindeki setPanModeListener yöntemini kullanarak kullanıcının kaydırma moduna girme veya bu moddan çıkma işlemine yanıt verin. Kullanıcı kaydırma modundayken ev sahibi, şablondaki diğer kullanıcı arayüzü bileşenlerini gizleyebilir.

Kullanıcıyla etkileşim kurma

Uygulamanız, mobil uygulamaya benzer kalıplar kullanarak kullanıcıyla etkileşim kurabilir.

Kullanıcı girişini işleme

Uygulamanız, uygun dinleyicileri destekleyen modellere ileterek kullanıcı girişine yanıt verebilir. Aşağıdaki snippet'te, uygulamanızın kodu tarafından tanımlanan bir yöntemi geri çağıran bir OnClickListener ayarlayan bir Action modelinin nasıl oluşturulacağı gösterilmektedir:

val action = Action.Builder()
    .setTitle("Navigate")
    .setOnClickListener(::onClickNavigate)
    .build()

Action action = new Action.Builder()
    .setTitle("Navigate")
    .setOnClickListener(this::onClickNavigate)
    .build();

onClickNavigate yöntemi, CarContext.startCarApp yöntemini kullanarak varsayılan navigasyon araba uygulamasını başlatabilir:

private fun onClickNavigate() {
    val intent = Intent(CarContext.ACTION_NAVIGATE, Uri.parse("geo:0,0?q=" + address))
    carContext.startCarApp(intent)
}

private void onClickNavigate() {
    Intent intent = new Intent(CarContext.ACTION_NAVIGATE, Uri.parse("geo:0,0?q=" + address));
    getCarContext().startCarApp(intent);
}

ACTION_NAVIGATE intent'inin biçimi de dahil olmak üzere uygulamaların nasıl başlatılacağı hakkında daha fazla bilgi için Bir intent ile araç uygulaması başlatma bölümüne bakın.

Kullanıcıyı mobil cihazlarında etkileşime devam etmeye yönlendirmeyi gerektiren işlemler gibi bazı işlemlere yalnızca araç park halindeyken izin verilir. Bu işlemleri uygulamak için ParkedOnlyOnClickListener simgesini kullanabilirsiniz. Araç park halinde değilse ev sahibi, kullanıcıya bu durumda işleme izin verilmediğini belirten bir gösterge gösterir. Araba park halindeyse kod normal şekilde yürütülür. Aşağıdaki snippet'te, mobil cihazda bir ayarlar ekranı açmak için ParkedOnlyOnClickListener öğesinin nasıl kullanılacağı gösterilmektedir:

val row = Row.Builder()
    .setTitle("Open Settings")
    .setOnClickListener(ParkedOnlyOnClickListener.create(::openSettingsOnPhone))
    .build()

Row row = new Row.Builder()
    .setTitle("Open Settings")
    .setOnClickListener(ParkedOnlyOnClickListener.create(this::openSettingsOnPhone))
    .build();

Bildirimleri görüntüleme

Mobil cihaza gönderilen bildirimler yalnızca CarAppExtender ile genişletildiklerinde araç ekranında gösterilir. İçerik başlığı, metin, simge ve işlemler gibi bazı bildirim özellikleri CarAppExtender'te ayarlanabilir. Bu sayede, araba ekranında görünen bildirimin özellikleri geçersiz kılınabilir.

Aşağıdaki snippet'te, araba ekranına mobil cihazda gösterilenden farklı bir başlığın nasıl gönderileceği gösterilmektedir:

val notification = NotificationCompat.Builder(context, NOTIFICATION_CHANNEL_ID)
    .setContentTitle(titleOnThePhone)
    .extend(
        CarAppExtender.Builder()
            .setContentTitle(titleOnTheCar)
            ...
            .build())
    .build()

Notification notification = new NotificationCompat.Builder(context, NOTIFICATION_CHANNEL_ID)
    .setContentTitle(titleOnThePhone)
    .extend(
        new CarAppExtender.Builder()
            .setContentTitle(titleOnTheCar)
            ...
            .build())
    .build();

Bildirimler, kullanıcı arayüzünün aşağıdaki bölümlerini etkileyebilir:

• Kullanıcıya bir uyarı bildirimi (HUN) gösterilebilir.
• Bildirim merkezine bir giriş eklenebilir. İsteğe bağlı olarak, çubuğunda bir rozet gösterilebilir.
• Navigasyon uygulamaları için bildirim, Adım adım yol tarifi bildirimleri bölümünde açıklandığı gibi çubuklu widget'ta gösterilebilir.

CarAppExtender dokümanlarında açıklandığı gibi, bildirimin önceliğini kullanarak uygulamanızın bildirimlerini bu kullanıcı arayüzü öğelerinin her birini etkileyecek şekilde yapılandırmayı seçebilirsiniz.

NotificationCompat.Builder.setOnlyAlertOnce true değeriyle çağrılırsa yüksek öncelikli bildirim yalnızca bir kez HUN olarak gösterilir.

Araba uygulamanızın bildirimlerini tasarlama hakkında daha fazla bilgi için Bildirimler ile ilgili Google'ın Sürüş İçin Tasarım kılavuzuna bakın.

Kısa iletileri gösterme

Uygulamanız, bu snippet'te gösterildiği gibi CarToast kullanarak bir durum mesajı gösterebilir:

CarToast.makeText(carContext, "Hello!", CarToast.LENGTH_SHORT).show()

CarToast.makeText(getCarContext(), "Hello!", CarToast.LENGTH_SHORT).show();

İzin isteme

Uygulamanızın kısıtlanmış verilere veya işlemlere (ör. konum) erişmesi gerekiyorsa Android izinlerinin standart kuralları geçerlidir. İzin istemek için CarContext.requestPermissions() yöntemini kullanabilirsiniz.

Standart Android API'lerini kullanmak yerine CarContext.requestPermissions()'ü kullanmanın avantajı, izin iletişim kutusunu oluşturmak için kendi Activity'ınızı başlatmanız gerekmemesidir. Ayrıca, platforma bağlı akışlar oluşturmak zorunda kalmak yerine aynı kodu hem Android Auto hem de Android Automotive OS'te kullanabilirsiniz.

Android Auto'daki izin iletişim kutusunu biçimlendirme

Android Auto'da, kullanıcının izin iletişim kutusu telefonda görünür. Varsayılan olarak iletişim kutusunun arkasında arka plan yoktur. Özel bir arka plan ayarlamak için AndroidManifest.xml dosyanızda bir araç uygulaması teması tanımlayın ve araç uygulaması temanız için carPermissionActivityLayout özelliğini ayarlayın.

<meta-data
    android:name="androidx.car.app.theme"
    android:resource="@style/MyCarAppTheme />

Ardından, araba uygulaması temanız için carPermissionActivityLayout özelliğini ayarlayın:

<resources>
  <style name="MyCarAppTheme">
    <item name="carPermissionActivityLayout">@layout/my_custom_background</item>
  </style>
</resources>

Araç uygulamasını intent ile başlatma

Aşağıdaki işlemlerden birini gerçekleştirmek için CarContext.startCarApp yöntemini çağırabilirsiniz:

• Telefon görüşmesi yapmak için numara çeviriciyi açın.
• Varsayılan navigasyon aracı uygulaması ile bir konuma adım adım navigasyon başlatın.
• Intent ile kendi uygulamanızı başlatın.

Aşağıdaki örnekte, uygulamanızı bir park rezervasyonunun ayrıntılarını gösteren bir ekranla açan bir işlem içeren bildirimin nasıl oluşturulacağı gösterilmektedir. Bildirim örneğini, uygulamanızın işlemine açık bir intent sarmalayan bir PendingIntent içeren bir içerik intent'iyle genişletirsiniz:

val notification = notificationBuilder
    ...
    .extend(
        CarAppExtender.Builder()
            .setContentIntent(
                PendingIntent.getBroadcast(
                    context,
                    ACTION_VIEW_PARKING_RESERVATION.hashCode(),
                    Intent(ACTION_VIEW_PARKING_RESERVATION)
                        .setComponent(ComponentName(context, MyNotificationReceiver::class.java)),
                    0))
            .build())

Notification notification = notificationBuilder
    ...
    .extend(
        new CarAppExtender.Builder()
            .setContentIntent(
                PendingIntent.getBroadcast(
                    context,
                    ACTION_VIEW_PARKING_RESERVATION.hashCode(),
                    new Intent(ACTION_VIEW_PARKING_RESERVATION)
                        .setComponent(new ComponentName(context, MyNotificationReceiver.class)),
                    0))
            .build());

Uygulamanız, kullanıcı bildirim arayüzünde işlemi seçtiğinde ve CarContext.startCarApp'i veri URI'si içeren bir intent ile çağırdığında intent'i işlemek için çağrılan bir BroadcastReceiver de bildirmelidir:

class MyNotificationReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        val intentAction = intent.action
        if (ACTION_VIEW_PARKING_RESERVATION == intentAction) {
            CarContext.startCarApp(
                intent,
                Intent(Intent.ACTION_VIEW)
                    .setComponent(ComponentName(context, MyCarAppService::class.java))
                    .setData(Uri.fromParts(MY_URI_SCHEME, MY_URI_HOST, intentAction)))
        }
    }
}

public class MyNotificationReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        String intentAction = intent.getAction();
        if (ACTION_VIEW_PARKING_RESERVATION.equals(intentAction)) {
            CarContext.startCarApp(
                intent,
                new Intent(Intent.ACTION_VIEW)
                    .setComponent(new ComponentName(context, MyCarAppService.class))
                    .setData(Uri.fromParts(MY_URI_SCHEME, MY_URI_HOST, intentAction)));
        }
    }
}

Son olarak, uygulamanızdaki Session.onNewIntent yöntemi, park rezervasyonu ekranını yığına ekleyerek (henüz üstte değilse) bu amacı işler:

override fun onNewIntent(intent: Intent) {
    val screenManager = carContext.getCarService(ScreenManager::class.java)
    val uri = intent.data
    if (uri != null
        && MY_URI_SCHEME == uri.scheme
        && MY_URI_HOST == uri.schemeSpecificPart
        && ACTION_VIEW_PARKING_RESERVATION == uri.fragment
    ) {
        val top = screenManager.top
        if (top !is ParkingReservationScreen) {
            screenManager.push(ParkingReservationScreen(carContext))
        }
    }
}

@Override
public void onNewIntent(@NonNull Intent intent) {
    ScreenManager screenManager = getCarContext().getCarService(ScreenManager.class);
    Uri uri = intent.getData();
    if (uri != null
        && MY_URI_SCHEME.equals(uri.getScheme())
        && MY_URI_HOST.equals(uri.getSchemeSpecificPart())
        && ACTION_VIEW_PARKING_RESERVATION.equals(uri.getFragment())
    ) {
        Screen top = screenManager.getTop();
        if (!(top instanceof ParkingReservationScreen)) {
            screenManager.push(new ParkingReservationScreen(getCarContext()));
        }
    }
}

Araç uygulamasının bildirimlerini yönetme hakkında daha fazla bilgi için Bildirimleri görüntüleme bölümüne bakın.

Şablon kısıtlamaları

Barındırıcı, belirli bir görev için gösterilecek şablon sayısını en fazla beşle sınırlar. Bu şablonlardan sonuncusu aşağıdaki türlerden biri olmalıdır:

• NavigationTemplate
• PaneTemplate
• MessageTemplate

Bu sınırın, yığıntaki Screen örneğinin sayısı için değil, şablon sayısı için geçerli olduğunu unutmayın. Örneğin, bir uygulama A ekranındayken iki şablon gönderir ve ardından B ekranına geçerse artık üç şablon daha gönderebilir. Alternatif olarak, her ekran tek bir şablon gönderecek şekilde yapılandırılmışsa uygulama, ScreenManager yığınına beş ekran örneği gönderebilir.

Bu kısıtlamalar için özel durumlar vardır: şablon yenileme ve geri alma ve sıfırlama işlemleri.

Şablon yenilemeleri

Belirli içerik güncellemeleri, şablon sınırına dahil edilmez. Genel olarak, bir uygulama aynı türde ve önceki şablonla aynı ana içeriği içeren yeni bir şablon yayınlarsa yeni şablon kotaya dahil edilmez. Örneğin, ListTemplate içindeki bir satırın açma/kapatma durumunu güncellemek kotaya dahil edilmez. Ne tür içerik güncellemelerinin yenileme olarak değerlendirilebileceği hakkında daha fazla bilgi edinmek için şablonların dokümanlarına bakın.

Geri işlemleri

Ana makine, bir görevdeki alt akışları etkinleştirmek için bir uygulamanın ScreenManager yığınından Screen çıkardığını algılar ve kalan kotayı, uygulamanın geri gittiği şablon sayısına göre günceller.

Örneğin, uygulama A ekranındayken iki şablon gönderir, ardından B ekranını iter ve iki şablon daha gönderirse uygulamanın kotası bir kalır. Uygulama daha sonra A ekranına geri dönerse ana makine, kotayı üçe sıfırlar çünkü uygulama iki şablon geri gitmiştir.

Bir uygulamanın, bir ekrana geri dönerken söz konusu ekran tarafından en son gönderilenle aynı türde bir şablon göndermesi gerektiğini unutmayın. Diğer şablon türleri gönderildiğinde hata oluşur. Ancak, geri alma işlemi sırasında tür aynı kaldığı sürece uygulama, kotayı etkilemeden şablonun içeriğini özgürce değiştirebilir.

Sıfırlama işlemleri

Bazı şablonlarda, bir görevin sonunu belirten özel anlamlar bulunur. Örneğin, NavigationTemplate, ekranda kalmasının ve kullanıcının kullanımına yönelik yeni adım adım talimatlarla yenilenmesi beklenen bir görünümdür. Bu şablonlardan birine ulaştığında ana makine, şablon kotasını sıfırlayarak söz konusu şablonu yeni bir görevin ilk adımıymış gibi ele alır. Bu, uygulamanın yeni bir görev başlatmasına olanak tanır. Hangi şablonların ana makinede sıfırlama işlemi tetiklediğini görmek için şablonların dokümanlarına bakın.

Düzenleyen, bildirim işleminden veya başlatıcıdan uygulamayı başlatma amacı alırsa kota da sıfırlanır. Bu mekanizma, bir uygulamanın bildirimlerden yeni bir görev akışı başlatmasına olanak tanır. Bu durum, uygulama zaten bağlı ve ön planda olsa bile geçerlidir.

Uygulamanızın bildirimlerinin araç ekranında nasıl gösterileceği hakkında daha fazla bilgi için Bildirimleri gösterme bölümüne bakın. Uygulamanızı bildirim işleminden nasıl başlatacağınız hakkında bilgi edinmek için Bir araba uygulamasını intent ile başlatma bölümüne bakın.

Connection API

Uygulamanızın Android Auto'da mı yoksa Android Automotive OS'te mi çalıştığını belirlemek için CarConnection API'yi kullanarak çalışma zamanında bağlantı bilgilerini alabilirsiniz.

Örneğin, araba uygulamanızın Session bölümünde bir CarConnection başlatın ve LiveData güncellemelerine abone olun:

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

new CarConnection(getCarContext()).getType().observe(this, this::onConnectionStateUpdated);

Ardından gözlemcide, bağlantı durumundaki değişikliklere tepki verebilirsiniz:

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()
}

private void onConnectionStateUpdated(int connectionState) {
  String message;
  switch(connectionState) {
    case CarConnection.CONNECTION_TYPE_NOT_CONNECTED:
      message = "Not connected to a head unit";
      break;
    case CarConnection.CONNECTION_TYPE_NATIVE:
      message = "Connected to Android Automotive OS";
      break;
    case CarConnection.CONNECTION_TYPE_PROJECTION:
      message = "Connected to Android Auto";
      break;
    default:
      message = "Unknown car connection type";
      break;
  }
  CarToast.makeText(getCarContext(), message, CarToast.LENGTH_SHORT).show();
}

Constraints API

Farklı araçlar, kullanıcıya aynı anda farklı sayıda Item örneğinin gösterilmesine olanak tanıyabilir. Çalışma zamanında içerik sınırını kontrol etmek ve şablonlarınızda uygun öğe sayısını ayarlamak için ConstraintManager değerini kullanın.

CarContext'dan ConstraintManager alarak başlayın:

val manager = carContext.getCarService(ConstraintManager::class.java)

ConstraintManager manager = getCarContext().getCarService(ConstraintManager.class);

Ardından, alınan ConstraintManager nesnesini ilgili içerik sınırı için sorgulayabilirsiniz. Örneğin, bir ızgara içinde görüntülenebilecek öğelerin sayısını almak için CONTENT_LIMIT_TYPE_GRID ile getContentLimit işlevini çağırın:

val gridItemLimit = manager.getContentLimit(ConstraintManager.CONTENT_LIMIT_TYPE_GRID)

int gridItemLimit = manager.getContentLimit(ConstraintManager.CONTENT_LIMIT_TYPE_GRID);

Oturum açma akışı ekleme

Uygulamanız kullanıcılara oturum açmış bir deneyim sunuyorsa arabanın ana ünitesinde uygulamanızda oturum açmayı yönetmek için Car App API 2 ve sonraki sürümlerde SignInTemplate ve LongMessageTemplate gibi şablonları kullanabilirsiniz.

SignInTemplate oluşturmak için SignInMethod tanımlayın. Araç Uygulama Kitaplığı şu anda aşağıdaki oturum açma yöntemlerini desteklemektedir:

• InputSignInMethod kullanıcı adı/şifre ile oturum açma
• PinSignInMethod, kullanıcının ana ünitede gösterilen PIN'i kullanarak telefonundan hesabını bağladığı PIN ile oturum açma işlemi için kullanılır.
• Google ile oturum açma ve One Tap gibi sağlayıcı oturum açma işlemleri için ProviderSignInMethod.
• QRCodeSignInMethod kullanıcı telefonunda oturum açmak için QR kodunu taradığında QR kodu oturum açma Bu özellik, Car API 4 ve sonraki sürümlerde kullanılabilir.

Örneğin, kullanıcının şifresini toplayan bir şablon uygulamak için kullanıcı girişini işleyip doğrulamak üzere bir InputCallback oluşturarak başlayın:

val callback = object : InputCallback {
    override fun onInputSubmitted(text: String) {
        // You will receive this callback when the user presses Enter on the keyboard.
    }

    override fun onInputTextChanged(text: String) {
        // You will receive this callback as the user is typing. The update
        // frequency is determined by the host.
    }
}

InputCallback callback = new InputCallback() {
    @Override
    public void onInputSubmitted(@NonNull String text) {
        // You will receive this callback when the user presses Enter on the keyboard.
    }

    @Override
    public void onInputTextChanged(@NonNull String text) {
        // You will receive this callback as the user is typing. The update
        // frequency is determined by the host.
    }
};

InputSignInMethod Builder için bir InputCallback gereklidir.

val passwordInput = InputSignInMethod.Builder(callback)
    .setHint("Password")
    .setInputType(InputSignInMethod.INPUT_TYPE_PASSWORD)
    ...
    .build()

InputSignInMethod passwordInput = new InputSignInMethod.Builder(callback)
    .setHint("Password")
    .setInputType(InputSignInMethod.INPUT_TYPE_PASSWORD)
    ...
    .build();

Son olarak, yeni InputSignInMethod'inizi kullanarak bir SignInTemplate oluşturun.

SignInTemplate.Builder(passwordInput)
    .setTitle("Sign in with username and password")
    .setInstructions("Enter your password")
    .setHeaderAction(Action.BACK)
    ...
    .build()

new SignInTemplate.Builder(passwordInput)
    .setTitle("Sign in with username and password")
    .setInstructions("Enter your password")
    .setHeaderAction(Action.BACK)
    ...
    .build();

AccountManager'ı kullanma

Kimlik doğrulaması olan Android Automotive OS uygulamaları aşağıdaki nedenlerle AccountManager'ı kullanmalıdır:

• Daha iyi kullanıcı deneyimi ve hesap yönetimi kolaylığı: Kullanıcılar, oturum açma ve oturum kapatma dahil olmak üzere tüm hesaplarını sistem ayarlarındaki hesap menüsünden kolayca yönetebilir.
• "Konuk" deneyimleri: Arabalar paylaşılan cihazlar olduğundan OEM'ler, hesap eklenemeyen araçta konuk deneyimlerini etkinleştirebilir.

Metin dizesi varyantları ekleme

Farklı araba ekran boyutları farklı miktarlarda metin gösterebilir. Car App API 2. düzey ve üzeri sürümlerde, ekrana en uygun metin dizesini belirtmek için birden fazla varyant belirleyebilirsiniz. Metin varyantlarının nerede kabul edildiğini görmek için CarText alan şablonları ve bileşenler arayın.

CarText.Builder.addVariant() yöntemini kullanarak bir CarText öğesine metin dizesi varyantları ekleyebilirsiniz:

val itemTitle = CarText.Builder("This is a very long string")
    .addVariant("Shorter string")
    ...
    .build()

CarText itemTitle = new CarText.Builder("This is a very long string")
    .addVariant("Shorter string")
    ...
    .build();

Ardından bu CarText'yi (ör. GridItem'in birincil metni olarak) kullanabilirsiniz.

GridItem.Builder()
    .addTitle(itemTitle)
    ...
    .build()

new GridItem.Builder()
    .addTitle(itemTitle)
    ...
    build();

Dilerseniz dizelerinizi en çok tercih edilenden en az tercih edilene göre (ör. en uzundan en kısaya) sıralayın. Barındırıcı, araç ekranındaki boşluğa göre uygun uzunluktaki dizeyi seçer.

Satırlar için satır içi CarIcons ekleme

CarIconSpan kullanarak uygulamanızın görsel çekiciliğini artırmak için metinle birlikte simgeler ekleyebilirsiniz. Bu aralıkları oluşturma hakkında daha fazla bilgi için CarIconSpan.create dokümanlarına bakın. Aralıklarla metin biçimlendirmenin işleyiş şekline genel bakış için Aralıklarla muhteşem metin biçimlendirme başlıklı makaleyi inceleyin.

  
val rating = SpannableString("Rating: 4.5 stars")
rating.setSpan(
    CarIconSpan.create(
        // Create a CarIcon with an image of four and a half stars
        CarIcon.Builder(...).build(),
        // Align the CarIcon to the baseline of the text
        CarIconSpan.ALIGN_BASELINE
    ),
    // The start index of the span (index of the character '4')
    8,
    // The end index of the span (index of the last 's' in "stars")
    16,
    Spanned.SPAN_INCLUSIVE_INCLUSIVE
)

val row = Row.Builder()
    ...
    .addText(rating)
    .build()
  
  

  
SpannableString rating = new SpannableString("Rating: 4.5 stars");
rating.setSpan(
        CarIconSpan.create(
                // Create a CarIcon with an image of four and a half stars
                new CarIcon.Builder(...).build(),
                // Align the CarIcon to the baseline of the text
                CarIconSpan.ALIGN_BASELINE
        ),
        // The start index of the span (index of the character '4')
        8,
        // The end index of the span (index of the last 's' in "stars")
        16,
        Spanned.SPAN_INCLUSIVE_INCLUSIVE
);
Row row = new Row.Builder()
        ...
        .addText(rating)
        .build();
  
  

Araç Donanım API'leri

Araç Uygulaması API'si 3. düzeyden itibaren Araç Uygulaması Kitaplığı'nda, araç özelliklerine ve sensörlere erişmek için kullanabileceğiniz API'ler bulunur.

Şartlar

API'leri Android Auto ile kullanmak için Android Auto modülünüzün build.gradle dosyasına androidx.car.app:app-projected bağımlılık ekleyin. Android Automotive OS için Android Automotive OS modülünüzün build.gradle dosyasına androidx.car.app:app-automotive bağımlılığı ekleyin.

Ayrıca, AndroidManifest.xml dosyanızda, kullanmak istediğiniz araç verilerini istemek için gereken ilgili izinleri belirtmeniz gerekir. Bu izinlerin kullanıcı tarafından size verilmesi gerektiğini unutmayın. Platforma bağımlı akışlar oluşturmak yerine, hem Android Auto hem de Android Automotive OS'te aynı kodu kullanabilirsiniz. Ancak gereken izinler farklıdır.

CarInfo

Bu tabloda, CarInfo API'leri tarafından sunulan özellikler ve bunları kullanmak için istemeniz gereken izinler açıklanmaktadır:

Örneğin, kalan aralığı almak için bir CarInfo nesnesi oluşturun, ardından bir OnCarDataAvailableListener oluşturup kaydedin:

val carInfo = carContext.getCarService(CarHardwareManager::class.java).carInfo

val listener = OnCarDataAvailableListener<EnergyLevel> { data ->
    if (data.rangeRemainingMeters.status == CarValue.STATUS_SUCCESS) {
      val rangeRemaining = data.rangeRemainingMeters.value
    } else {
      // Handle error
    }
  }

carInfo.addEnergyLevelListener(carContext.mainExecutor, listener)
…
// Unregister the listener when you no longer need updates
carInfo.removeEnergyLevelListener(listener)

CarInfo carInfo = getCarContext().getCarService(CarHardwareManager.class).getCarInfo();

OnCarDataAvailableListener<EnergyLevel> listener = (data) -> {
  if(data.getRangeRemainingMeters().getStatus() == CarValue.STATUS_SUCCESS) {
    float rangeRemaining = data.getRangeRemainingMeters().getValue();
  } else {
    // Handle error
  }
};

carInfo.addEnergyLevelListener(getCarContext().getMainExecutor(), listener);
…
// Unregister the listener when you no longer need updates
carInfo.removeEnergyLevelListener(listener);

Arabadan gelen verilerin her zaman kullanılabileceğini varsaymayın. Hata alırsanız istediğiniz verilerin neden alınamadığını daha iyi anlamak için istediğiniz değerin durumunu kontrol edin. CarInfo sınıfının tam tanımı için referans dokümanlarını inceleyin.

CarSensors

CarSensors sınıfı, aracın ivme ölçer, jiroskop, pusula ve konum verilerine erişmenizi sağlar. Bu değerlerin kullanılabilirliği OEM'ye bağlı olabilir. İvme ölçer, jiroskop ve pusuladan gelen verilerin biçimi, SensorManager API'den alacağınız verilerle aynıdır. Örneğin, aracın yönünü kontrol etmek için:

val carSensors = carContext.getCarService(CarHardwareManager::class.java).carSensors

val listener = OnCarDataAvailableListener<Compass> { data ->
    if (data.orientations.status == CarValue.STATUS_SUCCESS) {
      val orientation = data.orientations.value
    } else {
      // Data not available, handle error
    }
  }

carSensors.addCompassListener(CarSensors.UPDATE_RATE_NORMAL, carContext.mainExecutor, listener)
…
// Unregister the listener when you no longer need updates
carSensors.removeCompassListener(listener)

CarSensors carSensors = getCarContext().getCarService(CarHardwareManager.class).getCarSensors();

OnCarDataAvailableListener<Compass> listener = (data) -> {
  if (data.getOrientations().getStatus() == CarValue.STATUS_SUCCESS) {
    List<Float> orientations = data.getOrientations().getValue();
  } else {
    // Data not available, handle error
  }
};

carSensors.addCompassListener(CarSensors.UPDATE_RATE_NORMAL, getCarContext().getMainExecutor(),
    listener);
…
// Unregister the listener when you no longer need updates
carSensors.removeCompassListener(listener);

Araçtaki konum verilerine erişmek için android.permission.ACCESS_FINE_LOCATION iznini de belirtmeniz ve istemeniz gerekir.

Test

Android Auto'da test yaparken sensör verilerini simüle etmek için masaüstü ana birim kılavuzunun Sensörler ve Sensör yapılandırması bölümlerine bakın. Android Automotive OS'te test yaparken sensör verilerini simüle etmek için Android Automotive OS emülatör kılavuzunun Donanım durumunu taklit etme bölümüne bakın.

CarAppService, Oturum ve Ekran yaşam döngüleri

Session ve Screen sınıfları LifecycleOwner arayüzünü uygular. Kullanıcı uygulamayla etkileşimde bulunurken aşağıdaki diyagramlarda açıklandığı gibi Session ve Screen nesnelerinizin yaşam döngüsü geri çağırma işlevleri çağrılır.

CarAppService ve oturumun yaşam döngüleri

Tüm ayrıntılar için Session.getLifecycle yönteminin belgelerine bakın.

Ekranın yaşam döngüsü

Tüm ayrıntılar için Screen.getLifecycle yönteminin belgelerine bakın.

Araç mikrofonundan kayıt yapma

Uygulamanızın CarAppService ve CarAudioRecord API'sini kullanarak uygulamanıza kullanıcının araba mikrofonuna erişim izni verebilirsiniz. Kullanıcıların, araba mikrofonuna erişmek için uygulamanıza izin vermesi gerekir. Uygulamanız, kullanıcının uygulamanızdaki girişini kaydedip işleyebilir.

Kayıt izni

Ses kaydetmeden önce, AndroidManifest.xml uygulamanızda kayıt iznini belirtmeniz ve kullanıcıdan izin vermesini istemeniz gerekir.

<manifest ...>
   ...
   <uses-permission android:name="android.permission.RECORD_AUDIO" />
   ...
</manifest>

Çalışma zamanında kayıt izni istemeniz gerekir. Araba uygulamanızda izin isteğinde bulunma hakkında ayrıntılı bilgi için İzin iste bölümüne bakın.

Ses kaydet

Kullanıcı kayıt izni verdikten sonra sesi kaydedebilir ve işleyebilirsiniz.

val carAudioRecord = CarAudioRecord.create(carContext)
        carAudioRecord.startRecording()

        val data = ByteArray(CarAudioRecord.AUDIO_CONTENT_BUFFER_SIZE)
        while(carAudioRecord.read(data, 0, CarAudioRecord.AUDIO_CONTENT_BUFFER_SIZE) >= 0) {
            // Use data array
            // Potentially call carAudioRecord.stopRecording() if your processing finds end of speech
        }
        carAudioRecord.stopRecording()
 

CarAudioRecord carAudioRecord = CarAudioRecord.create(getCarContext());
        carAudioRecord.startRecording();

        byte[] data = new byte[CarAudioRecord.AUDIO_CONTENT_BUFFER_SIZE];
        while (carAudioRecord.read(data, 0, CarAudioRecord.AUDIO_CONTENT_BUFFER_SIZE) >= 0) {
            // Use data array
            // Potentially call carAudioRecord.stopRecording() if your processing finds end of speech
        }
        carAudioRecord.stopRecording();
 

Ses odağı

Araba mikrofonundan kayıt yaparken, devam eden medyanın durdurulduğundan emin olmak için önce ses odağını alın. Ses odağını kaybederseniz kaydı durdurun.

Aşağıda, ses odağını nasıl alacağınıza dair bir örnek verilmiştir:

 
val carAudioRecord = CarAudioRecord.create(carContext)
        
        // Take audio focus so that user's media is not recorded
        val audioAttributes = AudioAttributes.Builder()
            .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
            // Use the most appropriate usage type for your use case
            .setUsage(AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE)
            .build()
        
        val audioFocusRequest =
            AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE)
                .setAudioAttributes(audioAttributes)
                .setOnAudioFocusChangeListener { state: Int ->
                    if (state == AudioManager.AUDIOFOCUS_LOSS) {
                        // Stop recording if audio focus is lost
                        carAudioRecord.stopRecording()
                    }
                }
                .build()
        
        if (carContext.getSystemService(AudioManager::class.java)
                .requestAudioFocus(audioFocusRequest)
            != AudioManager.AUDIOFOCUS_REQUEST_GRANTED
        ) {
            // Don't record if the focus isn't granted
            return
        }
        
        carAudioRecord.startRecording()
        // Process the audio and abandon the AudioFocusRequest when done

CarAudioRecord carAudioRecord = CarAudioRecord.create(getCarContext());
        // Take audio focus so that user's media is not recorded
        AudioAttributes audioAttributes =
                new AudioAttributes.Builder()
                        .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
                        // Use the most appropriate usage type for your use case
                        .setUsage(AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE)
                        .build();

        AudioFocusRequest audioFocusRequest =
                new AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE)
                        .setAudioAttributes(audioAttributes)
                        .setOnAudioFocusChangeListener(state -> {
                            if (state == AudioManager.AUDIOFOCUS_LOSS) {
                                // Stop recording if audio focus is lost
                                carAudioRecord.stopRecording();
                            }
                        })
                        .build();

        if (getCarContext().getSystemService(AudioManager.class).requestAudioFocus(audioFocusRequest)
                != AUDIOFOCUS_REQUEST_GRANTED) {
            // Don't record if the focus isn't granted
            return;
        }

        carAudioRecord.startRecording();
        // Process the audio and abandon the AudioFocusRequest when done
 

Test Kitaplığı

Android for Cars Test Kitaplığı, uygulamanızın test ortamındaki davranışını doğrulamak için kullanabileceğiniz yardımcı sınıflar sağlar. Örneğin, SessionController, ana makineyle bağlantıyı simüle etmenize ve doğru Screen ile Template öğelerinin oluşturulup döndürüldüğünü doğrulamanıza olanak tanır.

Kullanım örnekleri için Örnekler bölümüne bakın.

Arabalar için Android uygulama kitaplığıyla ilgili sorunları bildirme

Kitaplıkla ilgili bir sorunla karşılaşırsanız Google Sorun Takip Aracı'nı kullanarak sorunu bildirin. Sorun şablonunda istenen tüm bilgileri doldurduğunuzdan emin olun.

Yeni sorun oluşturma

Yeni bir sorun göndermeden önce lütfen sorunun kitaplığın sürüm notlarında listelenip listelenmediğini veya sorun listesinde bildirilip bildirilmediğini kontrol edin. Takipçideki bir sorunun yıldızını tıklayarak sorunlara abone olabilir ve oy verebilirsiniz. Daha fazla bilgi için Bir soruna abone olma başlıklı makaleyi inceleyin.