com.google.android.vending.expansion.downloader

Interface IDownloaderClient

All Known Implementing Classes:

DownloadNotification

public interface IDownloaderClient

This interface should be implemented by the client activity for the downloader. It is used to pass status from the service to the client.

Field Summary

Fields

Modifier and Type	Field and Description
static int	STATE_COMPLETED
static int	STATE_CONNECTING
static int	STATE_DOWNLOADING
static int	STATE_FAILED
static int	STATE_FAILED_CANCELED
static int	STATE_FAILED_FETCHING_URL
static int	STATE_FAILED_SDCARD_FULL
static int	STATE_FAILED_UNLICENSED
static int	STATE_FETCHING_URL
static int	STATE_IDLE
static int	STATE_PAUSED_BY_REQUEST
static int	STATE_PAUSED_NEED_CELLULAR_PERMISSION
static int	STATE_PAUSED_NEED_WIFI
static int	STATE_PAUSED_NETWORK_SETUP_FAILURE Scary case.
static int	STATE_PAUSED_NETWORK_UNAVAILABLE
static int	STATE_PAUSED_ROAMING
static int	STATE_PAUSED_SDCARD_UNAVAILABLE
static int	STATE_PAUSED_WIFI_DISABLED Both STATE_PAUSED_WIFI_DISABLED and STATE_PAUSED_NEED_WIFI imply that Wi-Fi is unavailable and cellular permission will NOT restart the service.
static int	STATE_PAUSED_WIFI_DISABLED_NEED_CELLULAR_PERMISSION Both STATE_PAUSED_WIFI_DISABLED_NEED_CELLULAR_PERMISSION and STATE_PAUSED_NEED_CELLULAR_PERMISSION imply that Wi-Fi is unavailable and cellular permission will restart the service.

Method Summary

Methods

Modifier and Type	Method and Description
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.

Field Detail

STATE_IDLE

static final int STATE_IDLE

See Also:

Constant Field Values

STATE_FETCHING_URL

static final int STATE_FETCHING_URL

See Also:

Constant Field Values

STATE_CONNECTING

static final int STATE_CONNECTING

See Also:

Constant Field Values

STATE_DOWNLOADING

static final int STATE_DOWNLOADING

See Also:

Constant Field Values

STATE_COMPLETED

static final int STATE_COMPLETED

See Also:

Constant Field Values

STATE_PAUSED_NETWORK_UNAVAILABLE

static final int STATE_PAUSED_NETWORK_UNAVAILABLE

See Also:

Constant Field Values

STATE_PAUSED_BY_REQUEST

static final int STATE_PAUSED_BY_REQUEST

See Also:

Constant Field Values

STATE_PAUSED_WIFI_DISABLED_NEED_CELLULAR_PERMISSION

static final int STATE_PAUSED_WIFI_DISABLED_NEED_CELLULAR_PERMISSION

Both STATE_PAUSED_WIFI_DISABLED_NEED_CELLULAR_PERMISSION and STATE_PAUSED_NEED_CELLULAR_PERMISSION imply that Wi-Fi is unavailable and cellular permission will restart the service. Wi-Fi disabled means that the Wi-Fi manager is returning that Wi-Fi is not enabled, while in the other case Wi-Fi is enabled but not available.

See Also:

Constant Field Values

STATE_PAUSED_NEED_CELLULAR_PERMISSION

static final int STATE_PAUSED_NEED_CELLULAR_PERMISSION

See Also:

Constant Field Values

STATE_PAUSED_WIFI_DISABLED

static final int STATE_PAUSED_WIFI_DISABLED

Both STATE_PAUSED_WIFI_DISABLED and STATE_PAUSED_NEED_WIFI imply that Wi-Fi is unavailable and cellular permission will NOT restart the service. Wi-Fi disabled means that the Wi-Fi manager is returning that Wi-Fi is not enabled, while in the other case Wi-Fi is enabled but not available.

The service does not return these values. We recommend that app developers with very large payloads do not allow these payloads to be downloaded over cellular connections.

See Also:

Constant Field Values

STATE_PAUSED_NEED_WIFI

static final int STATE_PAUSED_NEED_WIFI

See Also:

Constant Field Values

STATE_PAUSED_ROAMING

static final int STATE_PAUSED_ROAMING

See Also:

Constant Field Values

STATE_PAUSED_NETWORK_SETUP_FAILURE

static final int STATE_PAUSED_NETWORK_SETUP_FAILURE

Scary case. We were on a network that redirected us to another website that delivered us the wrong file.

See Also:

Constant Field Values

STATE_PAUSED_SDCARD_UNAVAILABLE

static final int STATE_PAUSED_SDCARD_UNAVAILABLE

See Also:

Constant Field Values

STATE_FAILED_UNLICENSED

static final int STATE_FAILED_UNLICENSED

See Also:

Constant Field Values

STATE_FAILED_FETCHING_URL

static final int STATE_FAILED_FETCHING_URL

See Also:

Constant Field Values

STATE_FAILED_SDCARD_FULL

static final int STATE_FAILED_SDCARD_FULL

See Also:

Constant Field Values

STATE_FAILED_CANCELED

static final int STATE_FAILED_CANCELED

See Also:

Constant Field Values

STATE_FAILED

static final int STATE_FAILED

See Also:

Constant Field Values

Method Detail

onServiceConnected

void onServiceConnected(android.os.Messenger m)

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.

Parameters:

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

onDownloadStateChanged

void onDownloadStateChanged(int newState)

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.

Parameters:

newState - one of the STATE_* values defined in IDownloaderClient

onDownloadProgress

void onDownloadProgress(DownloadProgressInfo progress)

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.

Parameters:

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