ConsentInformation

interface ConsentInformation


用於向使用者收集同意聲明的實用方法。

摘要

巢狀類型

@Retention(value = SOURCE)
@IntDef(value = [ConsentStatus.UNKNOWN, ConsentStatus.NOT_REQUIRED, ConsentStatus.REQUIRED, ConsentStatus.OBTAINED])
annotation ConsentInformation.ConsentStatus

同意聲明狀態值。

在同意聲明資訊更新失敗時,要叫用的回呼介面定義。

在同意資訊成功更新時,要叫用的回呼介面定義。

隱私權選項規定狀態。

公開函式

Boolean

指出 SDK 是否已根據應用程式設定的訊息收集同意聲明。

Int

取得目前的同意聲明狀態。

ConsentInformation.PrivacyOptionsRequirementStatus!

取得狀態,指出是否需要隱私設定選項按鈕。

Boolean

如果有 ConsentForm,就會傳回 true,否則傳回 false

Unit
requestConsentInfoUpdate(
    activity: Activity!,
    consentRequestParameters: ConsentRequestParameters!,
    successListener: ConsentInformation.OnConsentInfoUpdateSuccessListener!,
    failureListener: ConsentInformation.OnConsentInfoUpdateFailureListener!
)

要求更新同意聲明資訊。

Unit

ConsentInformation 重設為已初始化的狀態。

公開函式

canRequestAds

fun canRequestAds(): Boolean

指出 SDK 是否已根據應用程式設定的訊息收集同意聲明。

此方法會傳回 false,直到 requestConsentInfoUpdate 呼叫為止。

呼叫 requestConsentInfoUpdate 後,當 getConsentStatus 傳回 NOT_REQUIREDOBTAINED 時,這個方法會傳回 true

傳回
Boolean

如果 SDK 已收集與應用程式所設定訊息相符的同意聲明,則為 true。

getConsentStatus

@ConsentInformation.ConsentStatus
fun getConsentStatus(): Int

取得目前的同意聲明狀態。

傳回
Int

UNKNOWN 直到呼叫 requestConsentInfoUpdate 為止,並預設為上一個工作階段的值,直到 requestConsentInfoUpdate 成功完成並呼叫 OnConsentInfoUpdateSuccessListener 為止。

getPrivacyOptionsRequirementStatus

fun getPrivacyOptionsRequirementStatus(): ConsentInformation.PrivacyOptionsRequirementStatus!

取得狀態,指出是否需要隱私設定選項按鈕。

傳回
ConsentInformation.PrivacyOptionsRequirementStatus!

UNKNOWN 直到 requestConsentInfoUpdate 呼叫為止,並預設為上一個工作階段的值,直到 requestConsentInfoUpdate 成功完成並呼叫為止。

isConsentFormAvailable

fun isConsentFormAvailable(): Boolean

如果有 ConsentForm,就會傳回 true,否則傳回 false

requestConsentInfoUpdate

fun requestConsentInfoUpdate(
    activity: Activity!,
    consentRequestParameters: ConsentRequestParameters!,
    successListener: ConsentInformation.OnConsentInfoUpdateSuccessListener!,
    failureListener: ConsentInformation.OnConsentInfoUpdateFailureListener!
): Unit

要求更新同意聲明資訊。

在呼叫 getConsentStatus 之前,必須在每個應用程式工作階段中呼叫此 API。

呼叫此 API 後,getConsentStatus API 傳回值會同步更新,以便保留先前應用程式工作階段 (如果有) 的同意聲明狀態。

呼叫 後,getConsentStatus 可能會再次更新為最新狀態。

參數
activity: Activity!

用於收集螢幕剪輯內容的活動。

consentRequestParameters: ConsentRequestParameters!

要求參數。

successListener: ConsentInformation.OnConsentInfoUpdateSuccessListener!

同意聲明要求成功事件監聽器。

failureListener: ConsentInformation.OnConsentInfoUpdateFailureListener!

同意聲明要求失敗事件監聽器。

重設

fun reset(): Unit

ConsentInformation 重設為初始化狀態。這項功能僅供偵錯使用。