本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
安卓手机认证 SDK
这些实用程序可帮助您在通过安卓应用程序拨打 Amazon Location Service API 电话时进行身份验证。这在使用 Amazon Cognito 或API密钥作为身份验证方法时特别有用。
安卓手机身份验证SDK可在 github 上找到:安卓版 Amazon Location Service 移动身份验证SDK
安装
要使用移动设备身份验证SDK,请在 Android Studio 中将以下导入语句添加到您的build.gradle
文件中。
implementation("software.amazon.location:auth:0.0.1") implementation("com.amazonaws:aws-android-sdk-location:2.72.0")
身份验证功能
身份验证助手SDK具有以下功能:
authHelper.authenticateWithApiKey("My-Amazon-Location-API-Key"): LocationCredentialsProvider
: 此函数返回LocationCredentialsProvider
初始化后的 API Key。authHelper.authenticateWithCognitoIdentityPool("My-Cognito-Identity-Pool-Id"): LocationCredentialsProvider
:此函数返回LocationCredentialsProvider
初始化后的,以便与 Amazon Cognito 身份池配合使用。
使用量
要在代码SDK中使用,请导入以下类:
import com.amazonaws.services.geo.AmazonLocationClient import software.amazon.location.auth.AuthHelper import software.amazon.location.auth.LocationCredentialsProvider
在创建身份验证帮助程序和位置客户端提供程序实例时,您有两个选项。您可以使用亚马逊位置API密钥或 Amazon Cognito 创建实例。
-
要使用 Amazon 位置API密钥创建身份验证帮助程序实例,请按如下方式声明帮助程序类:
var authHelper = AuthHelper(applicationContext) var locationCredentialsProvider : LocationCredentialsProvider = authHelper.authenticateWithApiKey("
My-Amazon-Location-API-Key
") -
要使用 Amazon Cognito 创建身份验证帮助程序实例,请按如下方式声明该帮助程序类:
var authHelper = AuthHelper(applicationContext) var locationCredentialsProvider : LocationCredentialsProvider = authHelper.authenticateWithCognitoIdentityPool("
My-Cognito-Identity-Pool-Id
")
您可以使用位置凭证提供程序创建 Amazon Location 客户端实例,然后调用亚马逊定位服务。以下示例搜索靠近指定纬度和经度的地方。
var locationClient = authHelper.getLocationClient(locationCredentialsProvider.getCredentialsProvider()) var searchPlaceIndexForPositionRequest = SearchPlaceIndexForPositionRequest().withIndexName("
My-Place-Index-Name
").withPosition(arrayListOf(30.405423, -97.718833)) var nearbyPlaces = locationClient.searchPlaceIndexForPosition(searchPlaceIndexForPositionRequest)