Android SDK API参考 android-sdk-api-reference
简介 intro
本文档详细介绍Android SDK为Adobe Pass身份验证公开的方法和回调，Adobe Pass身份验证版本1.7及更高版本支持这些方法和回调。 此处介绍的方法和回调函数在AccessEnabler.h和EntitlementDelegate.h头文件中定义。
有关最新的Android AccessEnabler SDK，请参阅https://tve.zendesk.com/hc/en-us/articles/204963219-Android-Native-AccessEnabler-Library。
注意： Adobe Pass身份验证团队建议您仅使用Adobe Pass身份验证 公共 API：
- 公共API在 上可用，并在所有支持的客户端类型上进行了全面测试。 对于任何公共功能，我们确保每个客户端类型都有相关方法的相应版本。
- 公共API需要尽可能保持稳定，以支持向后兼容性并确保合作伙伴集成不会中断。 但是，对于 非 公共API，我们保留在未来任何时候更改其签名的权利。 如果您遇到无法通过当前公共Adobe Pass身份验证API调用组合支持的特定流程，最好的方法是告知我们。 根据您的需求，我们可以修改公共API，并在以后提供稳定的解决方案。
ANDROID API api
- getInstance
- setOptions
- setRequestor
- setRequestorComplete
- checkAuthentication
- getAuthentication
- displayProviderDialog
- setSelectedProvider
- navigateToUrl
- getAuthenticationToken
- setAuthenticationStatus
- 预授权
- checkAuthorization
- getAuthorization
- setToken
- tokenRequestFailed
- 注销
- getselectedprovider
- selectedprovider
- getMetadata
- setmetadatastatus
- getVersion
Factory.getInstance getInstance
描述： 实例化访问启用程序对象。 每个应用程序实例应有一个访问启用程序实例。
引发 AccessEnablerException
public static AccessEnabler getInstance(Context appContext， String env_url， String softwareStatement， String redirectUrl)
引发 AccessEnablerException
可用性： v3.1.2+
参数：
- appContext： Android应用程序上下文。
- env_url：对于使用Adobe暂存环境进行测试，可以将env_url设置为“sp.auth-staging.adobe.com”
已弃用：
public static AccessEnabler getInstance(Context appContext)
throws AccessEnablerException
setRequestor setRequestor
描述： 建立程序员的身份。 在为Adobe Pass身份验证系统注册Adobe时，每个程序员都会分配一个唯一的ID。 在处理SSO和远程令牌时，当应用程序处于后台时，身份验证状态可能会更改，当应用程序进入前台时，可以再次调用setRequestor以便与系统状态同步（如果启用了SSO，则获取远程令牌，如果同时发生注销，则删除本地令牌）。
服务器响应包含MVPD列表以及附加到程序员标识的一些配置信息。 服务器响应由访问启用码在内部使用。 通过setRequestorComplete()回调只向应用程序显示操作的状态（即SUCCESS/FAIL）。
如果未使用 url 参数，则生成的网络调用将定向默认服务提供程序URL：Adobe版本/生产环境。
如果为 url 参数提供了值，则生成的网络调用将针对 url 参数中提供的所有URL。 所有配置请求都在单独的线程中同时触发。 在编译MVPD列表时，优先使用第一个响应程序。 对于列表中的每个MVPD， Access Enabler记住关联服务提供商的URL。 所有后续权利请求都定向到与服务提供程序相关联的URL，该URL在配置阶段与目标MVPD配对。
public void setRequestor(String requestorId)可用性： v3.0+
public void setRequestor(String requestorId, ArrayList<String> urls)可用性： v3.0+
参数：
-
requestorID：与程序员关联的唯一ID。 首次向Adobe Pass身份验证服务注册时，将Adobe分配的唯一ID传递到您的网站。
-
signedRequestorID：用您的私钥进行数字签名的请求者ID的副本。。
-
url：可选参数；默认情况下，使用Adobe服务提供程序(http://sp.auth.adobe.com/)。 此阵列允许您为Adobe提供的身份验证和授权服务指定端点（其他实例可能用于调试目的）。 您可以使用此选项指定多个Adobe Pass身份验证服务提供程序实例。 这样做时，MVPD列表由来自所有服务提供商的端点组成。 每个MVPD都与最快的服务提供程序相关联；即首先响应并支持该MVPD的服务提供程序。
已触发 回调： setRequestorComplete()
已弃用：
public void setRequestor(String requestorId， String signedRequestorId)
public void setRequestor(String requestorId， String signedRequestorId， ArrayList<String> url)
setRequestorComplete setRequestorComplete
描述： 由Access Enabler触发的回调，通知应用程序配置阶段已完成。 这是一个信号，表明应用程序可以开始发出授权请求。 在配置阶段完成之前，应用程序无法发出任何授权请求。
可用性： v1.0+
参数：
-
状态：可以采用以下值之一：
-
SDK >= 3.4.0
AccessEnablerConstants.ACCESS_ENABLER_STATUS_SUCCESS— 配置阶段已成功完成AccessEnablerConstants.ACCESS_ENABLER_STATUS_ERROR— 配置阶段失败
-
SDK < 3.4
AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS— 配置阶段已成功完成AccessEnabler.ACCESS_ENABLER_STATUS_ERROR— 配置阶段失败
-
触发者： setRequestor()
setOptions setOptions
描述： 配置全局SDK选项。 它接受 Map<字符串，字符串> 作为参数。 映射中的值将与SDK发出的每个网络调用一起传递到服务器。
这些值将传递到服务器，与当前流（身份验证/授权）无关。 如果要更改值，可以随时调用此方法。
可用性： v1.9.2+
参数：
-
选项：包含全局SDK选项的Map<字符串，字符串>。 目前，以下选项可用：
- applicationProfile — 可用于根据此值生成服务器配置。
- ap_vi -Experience CloudID (visitorID)。 此值以后可用于高级分析报表。
- ap_ai - Advertising ID
- device_info — 客户端信息，如下所述： 传递客户端信息设备连接和应用程序。
checkAuthentication checkAuthN
描述： 检查身份验证状态。 它通过在本地令牌存储空间中搜索有效的身份验证令牌来完成此操作。 此方法不执行任何网络调用，我们建议在主线程上调用它。 应用程序使用它来查询用户的身份验证状态并相应地更新UI（即更新登录/注销UI）。 身份验证状态通过 setAuthenticationStatus() 回调与应用程序通信。
如果MVPD支持“每个请求者的身份验证”功能，则可以在设备上存储多个身份验证令牌。 有关此功能的详细信息，请参阅Android技术概述中的缓存准则部分。
可用性： v1.0+
参数： 无
已触发 回调： setAuthenticationStatus()
getAuthentication getAuthN
描述： 启动完整的身份验证工作流。 首先检查身份验证状态。 如果尚未经过身份验证，则身份验证流状态 — 计算机将启动：
- 如果上次身份验证尝试成功，则会跳过MVPD选择阶段，并触发 navigateToUrl() 回调。 应用程序使用此回调实例化向用户显示MVPD登录页的WebView控件。
- 如果上次身份验证尝试不成功，或者用户明确注销，则会触发 displayProviderDialog() 回调。 您的应用程序使用此回调来显示MVPD选择UI。 此外，需要您的应用程序通过setSelectedProvider()方法向Access Enabler库通知用户的MVPD选择，以恢复身份验证流程。
在MVPD登录页面上验证用户的凭据时，应用程序需要监视用户在MVPD登录页面上验证时发生的多个重定向操作。 输入正确的凭据后，WebView控件将被重定向到由 AccessEnabler.ADOBEPASS_REDIRECT_URL 常量定义的自定义URL。 此URL不打算由WebView加载。 应用程序必须拦截此URL，并将此事件解释为登录阶段已完成的信号。 然后，它应将控制权移交给访问启用程序，以便完成身份验证流程(通过调用 getAuthenticationToken() 方法)。
如果MVPD支持“每个请求者的身份验证”功能，则可以在设备上存储多个身份验证令牌（每个程序员一个）。 有关此功能的详细信息，请参阅Android技术概述中的缓存准则部分。
最后，身份验证状态通过 setAuthenticationStatus() 回调传递给应用程序。
可用性： v1.0+
可用性： v1.8+
参数：
- forceAuthn：指定是否应启动身份验证流程的标志，无论用户是否已通过身份验证。
- 数据：包含要发送到Pay-TV pass服务的键值对的映射。 Adobe可以使用此数据启用未来的功能，而无需更改SDK。
已触发 回调： setAuthenticationStatus(), displayProviderDialog(), navigateToUrl(), sendTrackingData()
displayProviderDialog displayProviderDialog
描述 回调由Access Enabler触发，用于通知应用程序需要实例化适当的UI元素以允许用户选择所需的MVPD。 回调会提供MVPD对象的列表以及其他有助于正确构建选择UI面板的信息（例如指向MVPD徽标的URL、友好显示名称等）
用户选择所需的MVPD后，需要上层应用程序通过调用 setSelectedProvider() 并向其传递与用户的选择对应的MVPD的ID来恢复身份验证流程。
请注意，这是用户能够按下“返回”按钮的时刻，这相当于身份验证流中止。 在这种情况下，您的应用程序需要调用
setSelectedProvider()方法，并将 null 作为参数传递，以便为Access Enabler提供重置其身份验证状态计算机的机会。public void displayProviderDialog(ArrayList<Mvpd> mvpds)可用性： v1.0+
参数：
- mvpds：包含应用程序可用于构建MVPD选择UI元素的MVPD相关信息的MVPD对象列表。
触发者： getAuthentication(), getAuthorization()
setSelectedProvider setSelectedProvider
描述： 您的应用程序调用此方法以告知访问启用程序用户的MVPD选择。 应用程序可以使用此方法选择或更改用于身份验证的服务提供程序。
如果所选MVPD是TempPass MVPD，它随后将自动通过该MVPD进行身份验证，而无需调用getAuthentication()。
请注意，这不适用于提升临时传递，因为getAuthentication()方法提供了额外的参数。
将 null 作为参数传递时，Access Enabler假定用户已取消身份验证流程（即按“返回”按钮），并通过重置身份验证状态计算机和使用AccessEnablerConstants.PROVIDER_NOT_SELECTED_ERROR错误代码调用 setAuthenticationStatus() 回调进行响应。
可用性： v1.0+
参数： 无
已触发 回调： setAuthenticationStatus(), sendTrackingData(), navigateToUrl()
navigateToUrl navigagteToUrl
已弃用： 从Android SDK 3.0开始，仅当设备上不存在Chrome自定义选项卡时才使用navigateToUrl
描述： 由Access Enabler触发的回调，它通知应用程序需要向用户显示MVPD登录页才能输入其凭据。 Access Enabler将MVPD登录页面的URL作为参数传递。 您的应用程序需要实例化WebView控件并将其指向此URL。 此外，应用程序还需要监视WebView控件加载的URL并截获针对由AccessEnabler.ADOBEPASS_REDIRECT_URL (deprecated)常量定义的自定义URL的重定向操作。 发生此事件时，应用程序需要关闭或隐藏WebView控件，并通过调用 getAuthenticationToken() 方法将控件交回Access Enabler库。 Access Enabler通过从后端服务器检索身份验证令牌并将其本地存储在令牌存储中来完成身份验证流程。
请注意，这是用户能够按“返回”按钮的时刻，这相当于中止身份验证流。 在这种情况下，应用程序需要调用_setSelectedProvider()方法，将_null 作为参数传递，并为Access Enabler提供重置其身份验证状态计算机的机会。
可用性： v1.0+
参数：
- url：指向MVPD登录页面的URL
触发者： getAuthentication(), setSelectedProvider()
getAuthenticationToken getAuthNToken
已弃用： 从Android SDK 3.0开始，由于Chrome自定义选项卡用于身份验证，因此应用程序中不再使用此方法。
描述： 通过从后端服务器请求身份验证令牌来完成身份验证流程。 仅当发生以下情况时，应用程序才应调用此方法：托管MVPD登录页面的WebView控件被重定向到由AccessEnabler.ADOBEPASS_REDIRECT_URL常量定义的自定义URL。
可用性： v1.0+
参数：
- Cookie：在目标域中设置的Cookie（请参阅SDK中的演示应用程序以了解参考实施）。
已触发 回调： setAuthenticationStatus()，sendTrackingData()
setAuthenticationStatus setAuthNStatus
描述： 由Access Enabler触发的回调，它会通知
身份验证流状态的应用。 有很多
可能导致此流失败的位置，原因可能是用户的
互动或由于其他不可预见的情况(即网络
连接问题等)。 此回调会通知应用程序
身份验证流的成功/失败状态，同时
在需要时提供有关失败原因的其他信息。
可用性： v1.0+
参数：
-
状态：可以采用以下值之一：
AccessEnablerConstants.ACCESS_ENABLER_STATUS_SUCCESS— 身份验证流程已成功完成AccessEnablerConstants.ACCESS_ENABLER_STATUS_ERROR— 身份验证流失败
-
代码：失败原因。 如果 状态 为
AccessEnablerConstants.ACCESS_ENABLER_STATUS_SUCCESS，则 代码 为空字符串（即，由AccessEnablerConstants.USER_AUTHENTICATED常量定义）。 如果失败，此参数可以采用以下值之一：AccessEnablerConstants.USER_NOT_AUTHENTICATED_ERROR— 用户未经过身份验证。 在本地令牌缓存中没有有效的身份验证令牌时响应 checkAuthentication() 方法调用。AccessEnablerConstants.PROVIDER_NOT_SELECTED_ERROR- AccessEnabler在上层应用程序将 null 传递到setSelectedProvider()后重置了身份验证状态计算机以中止身份验证流程。 用户可能已取消身份验证流程（例如，已按下“后退”按钮）。AccessEnablerConstants.GENERIC_AUTHENTICATION_ERROR— 由于网络不可用或用户显式取消身份验证流等原因，身份验证流失败。
触发者： checkAuthentication(), getAuthentication(), checkAuthorization()
checkPreauthorizedResources checkPreauth
已弃用： 从Android SDK 3.6开始，预授权API将替换checkPreauthorizedResources，并提供扩展的错误代码。
描述： 应用程序使用此方法来确定用户是否已获得查看特定受保护资源的授权。 此方法的主要目的是检索用于装饰UI的信息（例如，使用锁定和解锁图标指示访问状态）。
public void checkPreauthorizedResources(ArrayList<String> resources)可用性： v1.3+
参数： resources参数是应检查其授权的资源数组。 列表中的每个元素都应该是一个表示资源ID的字符串。 资源ID的限制与getAuthorization()调用中的资源ID的限制相同，即，它应该是程序员与MVPD或媒体RSS片段之间建立的商定值。
已触发 回调： preauthorizedResources()
checkPreauthorizedResources checkPreauth2
已弃用： 从Android SDK 3.6开始，预授权API将替换checkPreauthorizedResources，并提供扩展的错误代码。
描述： 应用程序使用此方法来确定用户是否已获得查看特定受保护资源的授权。 此方法的主要目的是检索用于装饰UI的信息（例如，使用锁定和解锁图标指示访问状态）。
public void checkPreauthorizedResources(ArrayList<String> resources, boolean cache)可用性： v3.1+
参数： resources参数是应检查其授权的资源数组。 列表中的每个元素都应该是一个表示资源ID的字符串。 资源ID的限制与getAuthorization()调用中的资源ID的限制相同，即，它应该是程序员与MVPD或媒体RSS片段之间建立的商定值。
cache参数指定是否可以使用缓存的预授权响应。 默认情况下，缓存为true，SDK将返回之前缓存的响应（如果可用）。
已触发 回调： preauthorizedResources()
preauthorizedResources preauthResources
已弃用： 从Android SDK 3.6开始，预授权API将替换checkPreauthorizedResources，并提供扩展的错误代码。 将不会对新API调用preauthorizedResources回调。
描述： 由checkPreauthorizedResources()触发的回调。 提供用户已被授权查看的资源列表。
public void checkPreauthorizedResources(ArrayList<String> resources)可用性： v1.3+
参数： resources参数是用户已被授权查看的资源数组。
触发者： checkPreauthorizedResources()
checkAuthorization
描述： 应用程序使用此方法来检查授权状态。 首先检查身份验证状态。 如果未经过身份验证，则触发 setTokenRequestFailed() 回调，此方法将退出。 如果用户通过了身份验证，它还会触发授权流。 查看有关 getAuthorization() 方法的详细信息。
可用性： v1.0+
可用性： v1.8+
参数：
- resourceId：用户请求授权的资源的ID。
- 数据：包含要发送到Pay-TV pass服务的键值对的映射。 Adobe可以使用此数据启用未来的功能，而无需更改SDK。
已触发 回调： tokenRequestFailed(), setToken(),sendTrackingData(), setAuthenticationStatus()
getAuthorization
描述： 应用程序使用此方法来启动授权流。 如果用户尚未经过身份验证，它还会启动身份验证流程。 如果用户通过了身份验证，Access Enabler将继续发出对授权令牌（如果本地令牌缓存中不存在有效的授权令牌）和短期媒体令牌的请求。 获得短媒体令牌后，授权流程即被视为完成。 触发 setToken() 回调并将短媒体令牌作为参数传递给应用程序。 如果授权由于任何原因失败，则会触发 tokenRequestFailed() 回调并提供错误代码和详细信息。
可用性： v1.0+
可用性： v1.8+
参数：
- resourceId：用户请求授权的资源的ID。
- 数据：包含要发送到Pay-TV pass服务的键值对的映射。 Adobe可以使用此数据启用未来的功能，而无需更改SDK。
已触发 回调： tokenRequestFailed(), setToken(), sendTrackingData()
此方法还可以触发以下回调（如果还启动了身份验证流程）： setAuthenticationStatus()，displayProviderDialog()，navigateToUrl()
注意：请尽量使用checkAuthorization()而不是getAuthorization()。 getAuthorization()方法将启动完整的身份验证流程（如果用户未经过身份验证），这可能会导致程序员端的复杂实施。
setToken setToken
描述： 由Access Enabler触发的回调，通知应用程序授权流已成功完成。 短期媒体令牌还会作为参数提供。
可用性： v1.0+
参数：
- 令牌：短期媒体令牌
- resourceId：为其获取授权的资源
触发者： checkAuthorization()，getAuthorization()
tokenRequestFailed tokenRequestFailed
描述： 由Access Enabler触发的回调，通知上层应用程序授权流失败。
String errorCode， String errorDescription)
可用性： v1.0+
参数：
-
resourceId：为其获取授权的资源
-
错误代码：与失败方案关联的错误代码。 可能的值：
AccessEnablerConstants.USER_NOT_AUTHORIZED_ERROR— 用户无法授权给定资源
-
errorDescription：有关失败情况的其他详细信息。 如果此描述性字符串由于任何原因不可用，则Adobe Pass身份验证发送空字符串 (")。
MVPD可使用此字符串传递自定义错误消息或与销售相关的消息。 例如，如果订阅者被拒绝对资源的授权，则MVPD会发送消息，例如：“您当前在包中无法访问此渠道。 如果要升级包，请单击此处。” 消息由Adobe Pass身份验证通过此回调传递给程序员，程序员可以选择显示或忽略该消息。 Adobe Pass身份验证还可以使用此参数来提供可能导致错误的状况通知。 例如，“与提供商的授权服务通信时出现网络错误。”
触发者： checkAuthorization(), getAuthorization()
注销 logout
描述： 使用此方法启动注销流程。 注销是一系列HTTP重定向操作的结果，这是因为用户既需要从Adobe Pass身份验证服务器注销，也需要从MVPD服务器注销。 因此，使用Access Enabler库发出的简单HTTP请求无法完成此流程。 Chrome自定义选项卡由SDK用于执行HTTP重定向操作。 此流程将对用户可见，并在完成后关闭
可用性： v1.0+
参数： 无
已触发 回调：
- 适用于3.0之前版本的SDK的
navigateToUrl() - 适用于SDK版本> 3.0的
setAuthenticationStatus()
getselectedprovider getSelectedProvider
描述： 使用此方法确定当前选择的提供程序。
可用性： v1.0+
参数： 无
已触发 回调： selectedProvider()
selectedprovider
描述： 由Access Enabler触发的回调，它将有关当前所选MVPD的信息提供给应用程序。
可用性： v1.0+
参数：
- mvpd：包含有关当前所选MVPD信息的对象
触发者： getSelectedProvider()
getMetadata getMetadata
描述： 使用此方法检索Access Enabler库公开为元数据的信息。 应用程序可以通过提供复合MetadataKey对象来访问此信息。
public void getMetadata(MetadataKey metadataKey)可用性： v1.0+
有两种类型的元数据可供程序员使用：
- 静态元数据（身份验证令牌TTL、授权令牌TTL和设备ID）
- 用户元数据（用户特定的信息，例如用户ID和邮政编码；在身份验证和/或授权流期间，从MVPD传递到用户设备）
参数：
-
metadataKey：封装键和args变量的数据结构，其含义如下：
-
如果键为
METADATA_KEY_USER_META且参数包含名为METADATA_ARG_USER_META且值=[metadata_name]的SerializableNameValuePair对象，则将对用户元数据进行查询。 可用用户元数据类型的当前列表：-
zip— 邮政编码 -
householdID— 家庭标识符。 如果MVPD不支持子帐户，则它与userID相同。 -
maxRating— 用户的最大家长评级 -
userID— 用户标识符。 如果MVPD支持子帐户，并且该用户不是主帐户，则userID将不同于householdID。 -
channelID— 用户有权查看的渠道列表
-
-
如果键为
METADATA_KEY_DEVICE_ID，则进行查询以获取当前设备ID。 请注意，此功能默认处于禁用状态，程序员应联系Adobe以获取有关启用和费用的信息。 -
如果键为
METADATA_KEY_TTL_AUTHZ且参数包含名为METADATA_ARG_RESOURCE_ID且值为[resource_id]的SerializableNameValuePair对象，则进行查询以获取与指定资源关联的授权令牌的过期时间。 -
如果密钥为
METADATA_KEY_TTL_AUTHN，则进行查询以获取身份验证令牌过期时间。
-
METADATA_KEY_USER_META, METADATA_KEY_DEVICE_ID, METADATA_KEY_TTL_AUTHZ, METADATA_KEY_TTL_AUTHN。已触发 回调： setMetadataStatus()
更多信息： 用户元数据
setmetadatastatus setMetadaStatus
描述： 由Access启用程序触发的回调，该启用程序提供通过 getMetadata() 调用请求的元数据。
public void setMetadataStatus(MetadataKey key, MetadataStatus result)可用性： v1.0+
参数：
-
key：包含为其请求元数据值的键和相关参数的MetadataKey对象（请参阅演示应用程序以了解参考实现）。
-
result：包含所请求元数据的复合对象。 该对象具有以下字段：
-
simpleResult：一个字符串，它表示在请求身份验证TTL、授权TTL或设备ID时的元数据值。 如果为用户元数据发出请求，则此值为null。
-
userMetadataResult：一个对象，它包含JSON用户元数据负载的Java表示形式。
例如：
-
'{
"street": "Main Avenue",
"buildings": ["150", "320"]
}'
翻译为Java的形式：
Map("street" -> "Main Avenue", "buildings" -> List("150", "320")))
用户元数据对象的实际结构类似于以下内容：
{
updated: 1334243471,
encrypted: ["encryptedProp"],
data: {
zip: ["12345", "34567"],
maxRating: {
"MPAA": "PG-13",
"VCHIP": "TV-Y",
"URL": "http://exam.pl/e/manage/ratings"
},
householdID: "3456",
userID: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=",
channelID: ["channel-1", "channel-2"]
}
}
请求简单元数据（身份验证TTL、授权TTL或设备ID）时，该值为空。
- encrypted：布尔值，它指定检索到的元数据是否加密。 此参数仅对用户元数据请求有意义，对于始终未加密接收的静态元数据（例如：身份验证TTL）没有意义。 如果此参数设置为True，则由程序员决定是否使用列入白名单的私钥（与在
setRequestor调用中用于请求者ID签名的私钥相同）执行RSA解密，以获取未加密的用户元数据值。
触发者： getMetadata()
更多信息： 用户元数据
getVersion getVersion
描述： 此方法可用于检索AccessEnabler库的版本。
public static String getVersion()跟踪事件 tracking
Access Enabler会触发一个附加回调，该回调不一定与权利文件流相关。 实施名为 sendTrackingData() 的事件跟踪回调函数是可选的，但它使应用程序能够跟踪特定事件并编译统计信息，如成功/失败的身份验证/授权尝试次数。 以下是 sendTrackingData() 回调的规范：
sendTrackingData sendTrackingData
描述： 由Access Enabler向应用程序发出各种事件信号（如身份验证/授权流完成/失败）触发的回调。 sendTrackingData()还会报告设备类型、Access Enabler客户端类型和操作系统。
-
设备类型的可能值：
computertabletmobilegameconsoleunknown
-
Access Enabler客户端类型的可能值：
flashhtml5iosandroid
public void sendTrackingData(Event event, ArrayList<String> data)可用性： v1.0+
参数：
-
event：正在跟踪的事件。 有三种可能的跟踪事件类型：
- authorizationDetection： 每次返回授权令牌请求时（事件类型为
EVENT_AUTHZ_DETECTION） - authenticationDetection： 任何时候进行身份验证检查（事件类型为
EVENT_AUTHN_DETECTION） - mvpdSelection： 用户在MVPD选择表单中选择MVPD时（事件类型为
EVENT_MVPD_SELECTION）
- authorizationDetection： 每次返回授权令牌请求时（事件类型为
-
数据：与报告事件关联的其他数据。 此数据以值列表的形式提供。
以下说明用于解释 data 中的值
数组：
-
对于事件类型
EVENT_AUTHN_DETECTION：- 0 — 令牌请求是否成功(true/false)，如果以上为true：
- 1 - MVPD ID字符串
- 2 - GUID （md5散列）
- 3 — 令牌已在缓存中(true/false)
- 4 — 设备类型
- 5 - Access Enabler客户端类型
- 6 — 操作系统类型
-
对于事件类型
EVENT_AUTHZ_DETECTION- 0 — 令牌请求是否成功(true/false)，如果成功：
- 1 - MVPD ID
- 2 - GUID （md5散列）
- 3 — 令牌已在缓存中(true/false)
- 4 — 错误
- 5 — 详细信息
- 6 — 设备类型
- 7 - Access Enabler客户端类型
- 8 — 操作系统类型
-
对于事件类型
EVENT_MVPD_SELECTION- 0 — 当前所选MVPD的ID
- 1 — 设备类型
- 2 - Access Enabler客户端类型
- 3 — 操作系统类型
触发者： checkAuthentication()，getAuthentication()，checkAuthorization()，getAuthorization()，setSelectedProvider()