| // Copyright 2019 The Chromium Authors |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #ifndef CHROME_BROWSER_MEDIA_ANDROID_CDM_PER_DEVICE_PROVISIONING_PERMISSION_H_ |
| #define CHROME_BROWSER_MEDIA_ANDROID_CDM_PER_DEVICE_PROVISIONING_PERMISSION_H_ |
| |
| #include "base/functional/callback.h" |
| |
| namespace content { |
| class RenderFrameHost; |
| } |
| |
| // Background: Normally MediaDrmBridge must use per-origin provisioning if it's |
| // supported by the Android version. Otherwise per-device provisioning is used. |
| // See MediaDrmBridge::IsPerOriginProvisioningSupported(). Identifiers involved |
| // in provisioning in both cases are covered by "Protected Content" content |
| // setting and ProtectedMediaIdentifierPermissionContext, with different default |
| // settings and permission prompt strings in each case. However, it is possible |
| // that per-origin provisioning is supported, but does not work, e.g. cannot |
| // access the provisioning server. In some of these cases, falling back to |
| // per-device provisioning may work. Since per-device provisioning has different |
| // privacy implications than per-origin provisioning, we need to get user's |
| // permission before trying to fall back. This function helps get user |
| // permission in this case. This function should not be called when per-origin |
| // provisioning is NOT supported, in which case per-device provisioning should |
| // be used and is already covered by ProtectedMediaIdentifierPermissionContext. |
| // For more details, see https://crbug.com/917527. |
| |
| // Requests permission to allow MediaDrmBridge to use per-device provisioning. |
| // The |callback| is guaranteed to be called with whether the permission was |
| // allowed by the user. The decision is not persisted and does not affect any |
| // persisted settings, e.g. content settings. However, the last response is |
| // saved in memory, and if another request for the same origin happens within 15 |
| // minutes, the previous response is used. |
| void RequestPerDeviceProvisioningPermission( |
| content::RenderFrameHost* render_frame_host, |
| base::OnceCallback<void(bool)> callback); |
| |
| #endif // CHROME_BROWSER_MEDIA_ANDROID_CDM_PER_DEVICE_PROVISIONING_PERMISSION_H_ |
