Accedi a set di dati condivisi

A partire da Android 11 (livello API 30), il sistema memorizza nella cache set di dati di grandi dimensioni a cui potrebbero accedere più app per casi d'uso come il machine learning e la riproduzione di contenuti multimediali. Questa funzionalità consente di ridurre la ridondanza dei dati, sia sulla rete che sul disco.

Quando la tua app deve accedere a un set di dati di grandi dimensioni condiviso, può prima cercare questi set di dati memorizzati nella cache, chiamati blob di dati condivisi, prima di determinare se scaricare una nuova copia. Le app possono accedere a queste funzionalità dei set di dati condivisi utilizzando le API in BlobStoreManager.

Il sistema gestisce i blob di dati condivisi e controlla a quali app è consentito l'accesso. Quando la tua app contribuisce con blob di dati, puoi indicare a quali altre app deve essere concesso l'accesso chiamando uno dei seguenti metodi:

  • Per concedere l'accesso a un insieme specifico di app su un dispositivo, passa i nomi dei pacchetti di queste app in allowPackageAccess().
  • Per consentire solo le app i cui certificati sono firmati utilizzando la stessa chiave di quella utilizzata per la tua app, ad esempio una suite di app che gestisci, chiama allowSameSignatureAccess().
  • Per concedere l'accesso a tutte le app su un dispositivo, chiama allowPublicAccess().

Accedere ai blob di dati condivisi

Il sistema rappresenta ogni blob di dati condiviso utilizzando un oggetto BlobHandle. Ogni istanza di BlobHandle contiene un hash crittograficamente sicuro e alcuni dettagli identificativi per il set di dati.

Per accedere ai blob di dati condivisi, scarica i dettagli identificativi dal server. Utilizzando questi dettagli, controlla se il set di dati è già disponibile nel sistema.

Il passaggio successivo dipende dalla disponibilità dei dati.

Set di dati disponibile

Se il set di dati è già disponibile sul dispositivo, accedi al sistema, come mostrato nello snippet di codice seguente:

Kotlin

val blobStoreManager =
        getSystemService(Context.BLOB_STORE_SERVICE) as BlobStoreManager
// The label "Sample photos" is visible to the user.
val blobHandle = BlobHandle.createWithSha256(sha256DigestBytes,
        "Sample photos",
        System.currentTimeMillis() + TimeUnit.DAYS.toMillis(1),
        "photoTrainingDataset")
try {
    val input = ParcelFileDescriptor.AutoCloseInputStream(
            blobStoreManager.openBlob(blobHandle))
    useDataset(input)
}

Java

BlobStoreManager blobStoreManager =
        ((BlobStoreManager) getSystemService(Context.BLOB_STORE_SERVICE));
if (blobStoreManager != null) {
    // The label "Sample photos" is visible to the user.
    BlobHandle blobHandle = BlobHandle.createWithSha256(
            sha256DigestBytes,
            "Sample photos",
            System.currentTimeMillis() + TimeUnit.DAYS.toMillis(1),
            "photoTrainingDataset");
    try (InputStream input = new ParcelFileDescriptor.AutoCloseInputStream(
            blobStoreManager.openBlob(blobHandle))) {
        useDataset(input);
    }
}

Set di dati non disponibile

Se il set di dati non è disponibile, scaricalo dal server e contribuiscilo al sistema, come mostrato nello snippet di codice seguente:

Kotlin

val sessionId = blobStoreManager.createSession(blobHandle)
try {
    val session = blobStoreManager.openSession(sessionId)
    try {
        // For this example, write 200 MiB at the beginning of the file.
        val output = ParcelFileDescriptor.AutoCloseOutputStream(
                session.openWrite(0, 1024 * 1024 * 200))
        writeDataset(output)

        session.apply {
            allowSameSignatureAccess()
            allowPackageAccess(your-app-package,
                    app-certificate)
            allowPackageAccess(some-other-app-package,
                    app-certificate)
            commit(mainExecutor, callback)
        }
    }
}

Java

long sessionId = blobStoreManager.createSession(blobHandle);
try (BlobStoreManager.Session session =
        blobStoreManager.openSession(sessionId)) {
    // For this example, write 200 MiB at the beginning of the file.
    try (OutputStream output = new ParcelFileDescriptor.AutoCloseOutputStream(
            session.openWrite(0, 1024 * 1024 * 200)))
        writeDataset(output);
        session.allowSameSignatureAccess();
        session.allowPackageAccess(your-app-package,
                    app-certificate);
        session.allowPackageAccess(some-other-app-package,
                    app-certificate);
        session.commit(getMainExecutor(), callback);
    }
}