Pi SDK 集成视频指南
视频的字幕也可以在我们的Medium 博客文章中找到。
图片说明
集成 SDK
要使用 Pi SDK，您需要在前端添加一个 SDK 脚本标签。然后，您需要调用 `init` 函数来初始化 SDK。您需要指定版本号以确保与未来的 SDK 版本兼容。目前，最新版本为 2.0，因此我们在此处填写 2.0，并将沙盒标志设置为 true，稍后我会详细介绍。沙盒标志是可选的，它允许您配置 SDK 在沙盒环境中运行。如果您使用环境变量来控制此变量，将会非常方便，但为了明确起见，我在这里将其设置为 true。
开发者门户参数
我们进入开发者门户。我假设您已经像我一样在门户上注册了您的应用。要在沙盒环境中加载您的应用，您需要设置“开发 URL”。目前显示“未配置”，所以我们来编辑一下。这通常是 localhost，端口号取决于您的开发环境。这里我使用的是 localhost 和 3003 端口。设置开发 URL 后，系统会生成一个沙盒 URL。在桌面浏览器中打开此 URL，您会看到一个包含授权码的白色页面。如果您正在运行 Pi Node，您可能已经熟悉这个过程。打开您的移动应用，点击 Pi Utilities 页面底部的“授权沙盒”链接。然后您需要输入授权码并点击确认。沙盒环境获得授权后，您将在沙盒环境中看到您的应用，也就是您之前看到的页面。
沙盒（本地环境）
现在打开浏览器的开发者工具。这里有个小小的上下文选择器。你可以选择 localhost 来获取应用的上下文。选择 localhost 后，如果你在控制台中输入 Pi，就可以访问它了。当然，你会看到一些值为 null，因为当前用户尚未通过身份验证。
身份验证功能
现在我们可以在沙盒环境中运行应用了，接下来我们简单了解一下 SDK。你遇到的第一个函数是 authenticate 函数。它接受一个名为 scopes 的字符串数组和一个名为 onIncompletePaymentFound 的回调函数。
瞄准镜
目前有两个可用的权限范围：用户名和支付。权限范围功能仍在开发中。这意味着，目前身份验证函数会同时考虑这两个权限范围。不过，您应该只在应用中使用相关的权限范围。请关注我们托管在 GitHub 代码库中的 SDK 参考文档，以获取后续更新。
onIncompletePaymentFound 回调函数
`onIncompletePaymentFound` 函数用于处理您的应用与您正在验证的用户之间未完成的付款。如果您未提交服务器端完成 API 调用，则付款将被视为未完成。在本演示应用中，我们提供了一个示例用法，其中付款信息会发送到应用服务器以查找之前的订单并将其标记为已付款。有关付款的更多详细信息，请参阅“付款”视频。现在，我们只需记住，我们需要传递一个回调函数来处理服务器端的未完成付款。
验证来电
身份验证函数会返回一个 Promise 对象，其结构大致如下。返回值之后可能会有所变化，但重要的是，您需要确保将其发送到应用服务器并将此信息存储在数据库中。此外，您还需要通过服务器访问 `/me` 端点进行验证，因为恶意用户可以伪装成其他人。您可以在我们的 Pi 平台文档中找到更多关于 `/me` 端点的信息。
Pi 打赏
微信打赏