Lingua

JobInfo.Builder.SetEstimatedNetworkBytes(Int64, Int64) Metodo

Definizione

Impostare le dimensioni stimate del traffico di rete che verrà eseguito da questo processo, in byte.

[Android.Runtime.Register("setEstimatedNetworkBytes", "(JJ)Landroid/app/job/JobInfo$Builder;", "", ApiSince=28)]
public Android.App.Job.JobInfo.Builder? SetEstimatedNetworkBytes(long downloadBytes, long uploadBytes);
[<Android.Runtime.Register("setEstimatedNetworkBytes", "(JJ)Landroid/app/job/JobInfo$Builder;", "", ApiSince=28)>]
member this.SetEstimatedNetworkBytes : int64 * int64 -> Android.App.Job.JobInfo.Builder

Parametri

downloadBytes
Int64

Dimensioni stimate del traffico di rete che verrà scaricato da questo processo, in byte. Value è un numero non negativo di byte.

uploadBytes
Int64

Dimensioni stimate del traffico di rete che verrà caricato da questo processo, in byte. Value è un numero non negativo di byte.

Valori restituiti

Attributi

Commenti

Impostare le dimensioni stimate del traffico di rete che verrà eseguito da questo processo, in byte.

Le app sono incoraggiate a fornire valori il più accurati possibile, ma quando le dimensioni esatte non sono disponibili, è possibile fornire invece una stima di ordine di grandezza. Ecco alcuni esempi specifici:

Un lavoro che esegue il backup di una foto conosce le dimensioni esatte di tale foto, quindi dovrebbe fornire tale dimensione come stima.

Un processo che aggiorna le notizie principali non conosce una dimensione esatta, ma se si prevede che le dimensioni siano costantemente di circa 100 KB, può fornire tale valore di ordine di grandezza come stima.

Un processo che sincronizza la posta elettronica potrebbe finire usando una gamma estrema di dati, da meno di 1 KB quando nulla è cambiato, fino a decine di MB quando sono presenti nuovi messaggi di posta elettronica con allegati. I processi che non possono fornire stime ragionevoli devono usare il valore sentinel JobInfo.NETWORK_BYTES_UNKNOWN.

Si noti che il sistema può scegliere di ritardare i processi con stime di utilizzo di rete di grandi dimensioni quando il dispositivo ha una connessione di rete insufficiente, al fine di risparmiare batteria e possibili costi di rete. A partire dalla versione di Android Build.VERSION_CODES. S, JobScheduler può tentare di eseguire processi di grandi dimensioni quando il dispositivo viene ricaricato e in una rete senza parametri, anche se la rete è lenta. Ciò offre ai grandi posti di lavoro un'opportunità di avanzamento, anche se rischia il timeout.

I valori forniti qui riflettono solo il traffico che verrà eseguito dal processo di base; se si usa JobWorkItem, è anche necessario definire il traffico di rete usato da ogni elemento di lavoro durante la costruzione.

Prima della versione di Android Build.VERSION_CODES. TIRAMISU, JobScheduler ha usato i numeri di trasferimento stimati in modo simile a setMinimumNetworkChunkBytes(long) (per stimare se il lavoro verrebbe completato entro il tempo disponibile per il processo). In altre parole, JobScheduler ha considerato il trasferimento come tutto o niente. A partire dalla versione di Android Build.VERSION_CODES. TIRAMISU, JobScheduler userà i numeri di trasferimento stimati in questo modo solo se le dimensioni minime dei blocchi non sono state fornite tramite setMinimumNetworkChunkBytes(long).

Informazioni di riferimento su Android per android.app.job.JobInfo.Builder.setEstimatedNetworkBytes.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a