Çalışma durumunu bildirme

Bu kılavuzda, arka plan hizmetinde çalıştırılan bir iş isteğinin durumunu nasıl bildireceğiniz gösterilmektedir isteği gönderen bileşene iletir. Bu, örneğin, müşterinin Activity nesnesinin kullanıcı arayüzündeki isteği. Projeyi göndermek ve kullanmak için önerilen yöntem bir LocalBroadcastManager kullanmaktır. Bu işlem Intent nesneyi kendi uygulamanızdaki bileşenlerle sınırlandırır.

JobIntentService'ten rapor durumu

Bir JobIntentService içindeki iş isteğinin durumunu diğer bileşenlere göndermek için önce durumunu genişletilmiş verilerinde içeren bir Intent oluşturun. Bir seçenek olarak, buraya bir işlem ve veri URI'si ekleyebilirsiniz Intent

Ardından LocalBroadcastManager.sendBroadcast()'i LocalBroadcastManager.sendBroadcast() numaralı telefondan arayarak gönderin. Bu işlem, Intent öğesini bileşenini kullanmak isteyebilirsiniz. LocalBroadcastManager örneği almak için şu numarayı arayın: getInstance().

Örnek:

...
// Defines a custom Intent action
const val BROADCAST_ACTION = "com.example.android.threadsample.BROADCAST"
...
// Defines the key for the status "extra" in an Intent
const val EXTENDED_DATA_STATUS = "com.example.android.threadsample.STATUS"
...
class RSSPullService : JobIntentService() {
    ...
    /*
     * Creates a new Intent containing a Uri object
     * BROADCAST_ACTION is a custom Intent action
     */
    val localIntent = Intent(BROADCAST_ACTION).apply {
        // Puts the status into the Intent
        putExtra(EXTENDED_DATA_STATUS, status)
    }
    // Broadcasts the Intent to receivers in this app.
    LocalBroadcastManager.getInstance(this).sendBroadcast(localIntent)
    ...
}

public final class Constants {
    ...
    // Defines a custom Intent action
    public static final String BROADCAST_ACTION =
        "com.example.android.threadsample.BROADCAST";
    ...
    // Defines the key for the status "extra" in an Intent
    public static final String EXTENDED_DATA_STATUS =
        "com.example.android.threadsample.STATUS";
    ...
}
public class RSSPullService extends JobIntentService {
...
    /*
     * Creates a new Intent containing a Uri object
     * BROADCAST_ACTION is a custom Intent action
     */
    Intent localIntent =
            new Intent(Constants.BROADCAST_ACTION)
            // Puts the status into the Intent
            .putExtra(Constants.EXTENDED_DATA_STATUS, status);
    // Broadcasts the Intent to receivers in this app.
    LocalBroadcastManager.getInstance(this).sendBroadcast(localIntent);
...
}

Sonraki adım, gelen yayın Intent nesnelerinin orijinal iş isteğini gönderen bileşen

JobIntentService'ten durum yayınları alma

Intent yayın nesnelerini almak için şunun bir alt sınıfını kullanın: BroadcastReceiver. Alt sınıfta, LocalBroadcastManager bir Intent aldığında çağıran BroadcastReceiver.onReceive() geri çağırma yöntemini uygulayın. LocalBroadcastManager gelen Intent bilgisini iletir BroadcastReceiver.onReceive().

Örnek:

// Broadcast receiver for receiving status updates from the IntentService.
private class DownloadStateReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        ...
        /*
         * Handle Intents here.
         */
        ...
    }
}

// Broadcast receiver for receiving status updates from the IntentService.
private class DownloadStateReceiver extends BroadcastReceiver
{
    // Called when the BroadcastReceiver gets an Intent it's registered to receive
    @Override
    public void onReceive(Context context, Intent intent) {
...
        /*
         * Handle Intents here.
         */
...
    }
}

BroadcastReceiver tanımladıktan sonra filtre tanımlayabilirsiniz. doğru kitle segmentlerini seçin. Bunun için bir IntentFilter oluşturun. İlk snippet'te, filtrenin nasıl tanımlanacağı gösterilmektedir:

// Class that displays photos
class DisplayActivity : FragmentActivity() {
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        ...
        super.onCreate(savedInstanceState)
        ...
        // The filter's action is BROADCAST_ACTION
        var statusIntentFilter = IntentFilter(BROADCAST_ACTION).apply {
            // Adds a data filter for the HTTP scheme
            addDataScheme("http")
        }
        ...

// Class that displays photos
public class DisplayActivity extends FragmentActivity {
    ...
    public void onCreate(Bundle stateBundle) {
        ...
        super.onCreate(stateBundle);
        ...
        // The filter's action is BROADCAST_ACTION
        IntentFilter statusIntentFilter = new IntentFilter(
                Constants.BROADCAST_ACTION);

        // Adds a data filter for the HTTP scheme
        statusIntentFilter.addDataScheme("http");
        ...

BroadcastReceiver ve sistemle IntentFilter, şunun bir örneğini al: LocalBroadcastManager ve şunu çağırın: registerReceiver() yöntemidir. Bu sonraki snippet'te, BroadcastReceiver etiketinin nasıl kaydedileceği gösterilmektedir ve IntentFilter:

        // Instantiates a new DownloadStateReceiver
        val downloadStateReceiver = DownloadStateReceiver()
        // Registers the DownloadStateReceiver and its intent filters
        LocalBroadcastManager.getInstance(this)
                .registerReceiver(downloadStateReceiver, statusIntentFilter)
        ...

        // Instantiates a new DownloadStateReceiver
        DownloadStateReceiver downloadStateReceiver =
                new DownloadStateReceiver();
        // Registers the DownloadStateReceiver and its intent filters
        LocalBroadcastManager.getInstance(this).registerReceiver(
                downloadStateReceiver,
                statusIntentFilter);
        ...

Tek bir BroadcastReceiver, birden fazla yayın türünü işleyebilir. Her biri kendi eylemine sahip Intent nesne. Bu özellik ile şunları yapabilirsiniz: ve her işlem için ayrı bir kod tanımlamanıza gerek kalmadan Her işlem için BroadcastReceiver. Başka bir tane tanımlamak için Aynısı için IntentFilter BroadcastReceiver, IntentFilter ve aramayı tekrarla registerReceiver(). Örnek:

        /*
         * Instantiates a new action filter.
         * No data filter is needed.
         */
        statusIntentFilter = IntentFilter(ACTION_ZOOM_IMAGE)
        // Registers the receiver with the new filter
        LocalBroadcastManager.getInstance(this)
                .registerReceiver(downloadStateReceiver, statusIntentFilter)

        /*
         * Instantiates a new action filter.
         * No data filter is needed.
         */
        statusIntentFilter = new IntentFilter(Constants.ACTION_ZOOM_IMAGE);
        // Registers the receiver with the new filter
        LocalBroadcastManager.getInstance(this).registerReceiver(
                downloadStateReceiver,
                statusIntentFilter);

Intent yayını gönderirken Activity başlatılmaz veya devam ettirilmez. Activity için BroadcastReceiver, uygulamanız arka plandayken bile Intent nesnelerini alır ve işler ancak uygulamanızı ön plana zorlamaz. Şu durumda: Kullanıcı, uygulamanız kapalıyken arka planda gerçekleşen bir etkinlik hakkında bilgilendirilmek istiyorsanız görünürse Notification kullanın. Hiçbir zaman Activity gelen bir yayına yanıt olarak Intent.