Android 上的 Xbox Live Api 入门
09/21/2018
本文内容
若要将 Xbox Live Api 用于 Android 游戏,你可以使用预编译的二进制文件,或在你的项目中包含 Xbox Live API 源并生成它。
要求
必须使用 Visual Studio 2017 或更高版本才能构建 Xbox Live Api。 Visual Studio 实例需要以下组件才能生成和部署 Android 项目:
工作负荷
带有 c + + 的移动开发
单个组件
适用于 Android 的 Visual Studio 模拟器
Android SDK 设置(API 级别27)
将 Xbox Live SDK 添加到 Android 项目(使用预编译的二进制文件和 Http://diagnostics.office.com/#/download/?env=maven)
备注
下面的说明仅适用于使用 Gradle 作为内部版本系统的 Android 项目。
下载 SDK 程序包并将 Android SDK 二进制文件提取到本地文件夹(例如,C:\XboxLiveSDK)
在你的项目中,打开your_app > Gradle 脚本 > Gradle (project) ,并确保以下 http://diagnostics.office.com/#/download/?env=maven url 在**allprojects {存储库{} **中列出。
maven {
url "https://maven.google.com/"
}
maven {
url "file:///C:/XboxLiveSDK/Maven/"
}
第二个 url 是指向本地 Http://diagnostics.office.com/#/download/?env=maven 存储库的路径,其中包含 Android 版二进制文件的 Xbxo Live SDK。
在你的项目中,打开your_app > Gradle 脚本 > Gradle (Module: app) ,并将以下依赖关系添加到{} "依赖关系" 部分,以依赖 Xbox Live SDK 的最新版本:
compile(group: 'XsapiAndroid', name: 'com.microsoft.xboxlive', version: '0.0.0')
compile(group: 'androidxal', name: 'XalAndroidJava', version: '0.0.0')
compile(group: 'libHttpClientAndroid', name: 'libHttpClient', version: '0.0.0')
compile fileTree(dir: 'libs', include: ['*.jar'])
compile ('com.squareup.okhttp3:okhttp:3.10.0')
compile ('com.google.code.gson:gson:2.5') { force = true; }
compile ('com.google.android.gms:play-services-gcm:8.4.0') { force = true; }
compile ('org.simpleframework:simple-xml:2.7.1') { force = true; exclude group: 'xpp3', module: 'xpp3'; exclude group: 'stax', module: 'stax-api'; exclude group: 'stax', module: 'stax'}
对于本机 JNI 项目,通过单击 "查看 > 其他 Windows > 属性管理器",右键单击项目,选择 "添加现有属性表",最后选择 " Maven\ndk\xsapi.android.props",将耗材文件添加到项目中。 这应添加 lib 依赖关系并包含路径。
将这些 android 权限添加到你的 Java 应用的AndroidManifest 模板:
完成后,清单顶部应如下所示:
package="com.YourJavaProject"
android:versionCode="1"
android:versionName="1.0">
有关在 Android 上使用 Xbox Live Api 的说明
登录和授权
使用 Xbox Live Api 的 Android 游戏使用 Xbox 身份验证库(XAL),以便将玩家与其 Xbox Live 标识相关联。
在使用 XAL 为播放器签名后,你的游戏应创建一个xbox_live_context并作为参数传递 XAL 用户句柄。
此后,外观和xbox_live_context功能应与在任何其他平台上一样。
有关在 Android 游戏中使用 XAL 登录播放机的详细信息,请参阅在 android 上为 XAL 登录设置 Visual Studio。