com.google.android.vending.expansion.downloader.impl

Class DownloadNotification

java.lang.Object

com.google.android.vending.expansion.downloader.impl.DownloadNotification

All Implemented Interfaces:

IDownloaderClient

public class DownloadNotification
extends Object
implements IDownloaderClient

This class handles displaying the notification associated with the download queue going on in the download manager. It handles multiple status types; Some require user interaction and some do not. Some of the user interactions may be transient. (for example: the user is queried to continue the download on 3G when it started on WiFi, but then the phone locks onto WiFi again so the prompt automatically goes away)

The application interface for the downloader also needs to understand and handle these transient states.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DownloadNotification.ICustomNotification

Field Summary

Fields inherited from interface com.google.android.vending.expansion.downloader.IDownloaderClient

STATE_COMPLETED, STATE_CONNECTING, STATE_DOWNLOADING, STATE_FAILED, STATE_FAILED_CANCELED, STATE_FAILED_FETCHING_URL, STATE_FAILED_SDCARD_FULL, STATE_FAILED_UNLICENSED, STATE_FETCHING_URL, STATE_IDLE, STATE_PAUSED_BY_REQUEST, STATE_PAUSED_NEED_CELLULAR_PERMISSION, STATE_PAUSED_NEED_WIFI, STATE_PAUSED_NETWORK_SETUP_FAILURE, STATE_PAUSED_NETWORK_UNAVAILABLE, STATE_PAUSED_ROAMING, STATE_PAUSED_SDCARD_UNAVAILABLE, STATE_PAUSED_WIFI_DISABLED, STATE_PAUSED_WIFI_DISABLED_NEED_CELLULAR_PERMISSION

Method Summary

Methods

Modifier and Type	Method and Description
android.app.PendingIntent	getClientIntent()
void	onDownloadProgress(DownloadProgressInfo progress) Shows the download progress.
void	onDownloadStateChanged(int newState) Called when the download state changes.
void	onServiceConnected(android.os.Messenger m) Called internally by the stub when the service is bound to the client.
void	resendState()
void	setClientIntent(android.app.PendingIntent mClientIntent)
void	setMessenger(android.os.Messenger msg) Called in response to onClientUpdated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getClientIntent

public android.app.PendingIntent getClientIntent()

setClientIntent

public void setClientIntent(android.app.PendingIntent mClientIntent)

resendState

public void resendState()

onDownloadStateChanged

public void onDownloadStateChanged(int newState)

Description copied from interface: IDownloaderClient

Called when the download state changes. Depending on the state, there may be user requests. The service is free to change the download state in the middle of a user request, so the client should be able to handle this.

The Downloader Library includes a collection of string resources that correspond to each of the states, which you can use to provide users a useful message based on the state provided in this callback. To fetch the appropriate string for a state, call Helpers.getDownloaderStringResourceIDFromState(int).

What this means to the developer: The application has gotten a message that the download has paused due to lack of WiFi. The developer should then show UI asking the user if they want to enable downloading over cellular connections with appropriate warnings. If the application suddenly starts downloading, the application should revert to showing the progress again, rather than leaving up the download over cellular UI up.

Specified by:

onDownloadStateChanged in interface IDownloaderClient

Parameters:

newState - one of the STATE_* values defined in IDownloaderClient

onDownloadProgress

public void onDownloadProgress(DownloadProgressInfo progress)

Description copied from interface: IDownloaderClient

Shows the download progress. This is intended to be used to fill out a client UI. This progress should only be shown in a few states such as STATE_DOWNLOADING.

Specified by:

onDownloadProgress in interface IDownloaderClient

Parameters:

progress - the DownloadProgressInfo object containing the current progress of all downloads.

setMessenger

public void setMessenger(android.os.Messenger msg)

Called in response to onClientUpdated. Creates a new proxy and notifies it of the current state.

Parameters:

msg - the client Messenger to notify

onServiceConnected

public void onServiceConnected(android.os.Messenger m)

Description copied from interface: IDownloaderClient

Called internally by the stub when the service is bound to the client.

Critical implementation detail. In onServiceConnected we create the remote service and marshaler. This is how we pass the client information back to the service so the client can be properly notified of changes. We must do this every time we reconnect to the service.

That is, when you receive this callback, you should call DownloaderServiceMarshaller.CreateProxy(android.os.Messenger) to instantiate a member instance of IDownloaderService, then call IDownloaderService.onClientUpdated(android.os.Messenger) with the Messenger retrieved from your IStub proxy object.

Specified by:

onServiceConnected in interface IDownloaderClient

Parameters:

m - the service Messenger. This Messenger is used to call the service API from the client.