Uber Rides Android SDK 使用教程

Uber Rides Android SDK 使用教程

rides-android-sdk Uber Rides Android SDK (beta) 项目地址: https://gitcode.com/gh_mirrors/ri/rides-android-sdk

1. 项目介绍

Uber Rides Android SDK 是一个官方的 Android SDK，旨在帮助开发者在其应用中集成 Uber 的乘车服务。该 SDK 支持以下功能：

• 乘车请求按钮（Ride Request Button）
• 乘车请求深度链接（Ride Request Deeplinks）
• Uber 认证（Uber Authentication）
• REST API 调用

该 SDK 设计为至少兼容 Android SDK 15 及以上版本。在使用该 SDK 之前，开发者需要在 Uber 开发者网站上注册其应用程序。

2. 项目快速启动

2.1 安装

要使用 Uber Rides Android SDK，首先需要在项目的 build.gradle 文件中添加依赖项：

dependencies {
    implementation 'com.uber.sdk:rides-android:x.y.z'
}

请将 x.y.z 替换为最新版本的 SDK。

2.2 SDK 配置

在应用中，创建一个 SessionConfiguration 对象，并使用该对象初始化 SDK：

SessionConfiguration config = new SessionConfiguration.Builder()
    .setClientId("YOUR_CLIENT_ID") // 必须
    .setRedirectUri("YOUR_REDIRECT_URI") // 如果使用隐式授权，必须
    .setEnvironment(Environment.SANDBOX) // 用于测试
    .setScopes(Arrays.asList(Scope.PROFILE, Scope.RIDE_WIDGETS)) // 认证范围
    .build();

UberSdk.initialize(config);

2.3 使用乘车请求深度链接

可以通过以下代码创建并执行乘车请求深度链接：

RideParameters rideParams = new RideParameters.Builder()
    .setProductId("a1111c8c-c720-46c3-8534-2fcdd730040d")
    .setPickupLocation(37.775304, -122.417522, "Uber HQ", "1455 Market Street, San Francisco")
    .setDropoffLocation(37.795079, -122.4397805, "Embarcadero", "One Embarcadero Center, San Francisco")
    .build();

RideRequestDeeplink deeplink = new RideRequestDeeplink.Builder(context)
    .setSessionConfiguration(config)
    .setRideParameters(rideParams)
    .build();

deeplink.execute();

3. 应用案例和最佳实践

3.1 乘车请求按钮

可以在应用中添加一个乘车请求按钮，用户点击后会跳转到 Uber 应用进行乘车请求：

RideRequestButton requestButton = new RideRequestButton(context);
layout.addView(requestButton);

3.2 自定义按钮样式

可以通过 XML 自定义按钮的样式：

<com.uber.sdk.android.rides.RideRequestButton
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    uber:ub__style="white"/>

3.3 使用移动网页作为回退

如果用户没有安装 Uber 应用，可以设置回退到移动网页：

requestButton.setDeeplinkFallback(Deeplink.Fallback.MOBILE_WEB);

4. 典型生态项目

Uber Rides Android SDK 可以与其他 Android 应用集成，提供无缝的乘车体验。例如，旅行应用可以通过集成该 SDK，为用户提供一键叫车的功能。此外，本地生活服务应用也可以通过该 SDK 提供快速、便捷的出行解决方案。

通过以上步骤，开发者可以轻松地将 Uber 的乘车服务集成到自己的 Android 应用中，为用户提供更加便捷的出行选择。

rides-android-sdk Uber Rides Android SDK (beta) 项目地址: https://gitcode.com/gh_mirrors/ri/rides-android-sdk