Доступ к общим наборам данных

Начиная с Android 11 (API уровня 30) система кэширует большие наборы данных, к которым могут обращаться несколько приложений для таких случаев использования, как машинное обучение и воспроизведение мультимедиа. Эта функция помогает снизить избыточность данных как в сети, так и на диске.

Когда вашему приложению требуется доступ к общему большому набору данных, оно может сначала искать эти кэшированные наборы данных, называемые общими блобами данных , прежде чем определять, следует ли загружать новую копию. Приложения могут получать доступ к этим функциональным возможностям общих наборов данных с помощью API в BlobStoreManager .

Система поддерживает общие BLOB-объекты данных и контролирует, какие приложения могут получить к ним доступ. Когда ваше приложение предоставляет BLOB-объекты данных, вы можете указать, какие другие приложения должны иметь доступ, вызвав один из следующих методов:

  • Чтобы предоставить доступ к определенному набору приложений на устройстве, передайте имена пакетов этих приложений в allowPackageAccess() .
  • Чтобы разрешить доступ только тем приложениям, сертификаты которых подписаны с использованием того же ключа, что и ключ, используемый для вашего приложения (например, для набора приложений, которым вы управляете), вызовите allowSameSignatureAccess() .
  • Чтобы предоставить доступ всем приложениям на устройстве, вызовите allowPublicAccess() .

Доступ к общим данным

Система представляет каждый общий блок данных с помощью объекта BlobHandle . Каждый экземпляр BlobHandle содержит криптографически защищенный хэш и некоторые идентификационные данные для набора данных.

Чтобы получить доступ к общим данным, загрузите идентификационные данные с сервера. Используя эти данные, проверьте, доступен ли уже набор данных в системе.

Следующий шаг зависит от доступности данных.

Доступен набор данных

Если набор данных уже доступен на устройстве, то получите к нему доступ из системы, как показано в следующем фрагменте кода:

Котлин 

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)
}

Ява 

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);
    }
}

Набор данных недоступен

Если набор данных недоступен, загрузите его с сервера и добавьте в систему, как показано в следующем фрагменте кода:

Котлин 

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)
        }
    }
}

Ява 

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);
    }
}