Manifest dosyalarını yapılandırma

Uygulamanızın manifest dosyalarını Android Auto ve Android Automotive OS (AAOS) ile entegre olacak şekilde yapılandırın. Bu platformların keşif ve bağlantı özelliklerini etkinleştirmek için manifest dosyasında medya tarayıcı hizmetinizi bildirin. Medya kontrolleri gibi sistem kullanıcı arayüzü bileşenleri tarafından kullanılacak bir ilişkilendirme simgesi için başlatıcı simgesi de dahil olmak üzere gerekli uygulama simgelerini belirtin.

Manifest dosyaları hakkında daha fazla bilgi edinmek için Uygulama manifestine genel bakış başlıklı makaleyi inceleyin.

Medya tarayıcı hizmetinizi beyan etme

Android Auto ve AAOS, medya öğelerine göz atmak için medya tarayıcı hizmetiniz üzerinden uygulamanıza bağlanır. Android Auto ve AAOS'in hizmeti keşfedip uygulamanıza bağlanabilmesi için medya tarayıcı hizmetinizi manifestinizde bildirin.

Bu kod snippet'i, medya tarayıcı hizmetinizi manifestinizde nasıl bildireceğinizi gösterir. Bu kılavuzun bir sonraki bölümü olan Medya tarayıcı hizmeti oluşturma, hizmetin uygulanma sürecini ayrıntılı olarak açıklar.

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

Uygulama simgelerini belirtme

Uygulamanızı sistem kullanıcı arayüzünde temsil etmek için Android Auto ve AAOS'in kullanması gereken uygulama simgelerini belirtin. Şu iki simge gereklidir:

Başlatıcı simgesini tanımlama

Başlatıcı simgesi, uygulamanızı sistem kullanıcı arayüzünde (ör. başlatıcıda ve simge tepsisinde) temsil eder.

Varsayılan olarak, uygulamanızın android:icon özelliği, başlatıcı simgesi olarak kullanılır: <application> öğesi:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

Farklı bir simge kullanmak için medya tarayıcınızın hizmetinin <service> öğesinin android:icon özelliğini ayarlayın:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

İlişkilendirme simgesini tanımlama

Atıf simgesi, medya içeriğinin öncelikli olduğu yerlerde (ör. medya kartlarında) kullanılır. Bildirimler için kullanılan küçük simgeyi yeniden kullanabilirsiniz. Bu simge tek renkli olmalıdır.

Medya kartındaki ilişkilendirme simgesi

1.şekil Medya kartındaki ilişkilendirme simgesi.

Bu manifest bildirimini kullanarak uygulamanızı temsil etmek için kullanılan bir simge belirtebilirsiniz:

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

Uygulamanızın etiketini belirtme

Varsayılan olarak, uygulamanızın android:label özelliğinin değeri, araba ekranında uygulamanızın görünen adı olarak kullanılır.<application>

Farklı bir görünen ad kullanmak istiyorsanız veya uygulamanızda birden fazla medya tarayıcı hizmeti varsa medya tarayıcı hizmetinin android:label öğesinin <service> özelliğini ayarlayın.

Uygulamanızın vurgu rengini belirtme

Uygulamanızın vurgu rengi, Android Auto ve AAOS tarafından oynatma kontrollerini ve diğer kullanıcı arayüzü öğelerini stilize etmek için kullanılır.

Varsayılan olarak vurgu rengi, uygulamanızın <application> öğesinin android:theme stil kaynağının colorAccent öğesinden alınır.

Araç içi deneyiminizde farklı bir vurgu rengi kullanmak için colorAccent öğesini içeren farklı bir stil kaynağı için <meta-data> öğesini ekleyin:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

Platforma özgü yapılandırma

Bu sayfada ayrıntılı olarak açıklanan yapılandırmaya ek olarak, platforma özel koşullar için aşağıdaki bölümlere bakın: