iOS 上的 Photobook SDK

Photobook SDK 使得在您的应用内创建精美的、高质量的相册变得简单。

利用我们的全球印刷和发行网络，我们会为您处理所有繁杂的印刷和邮寄事宜！

要开始使用，您需要一个免费的 Kite 开发者账户。访问 kite.ly 并免费注册。

功能

• 按需打印各种大小的相册
• 使用我们的网络 开发者仪表板 动态和实时控制应用内产品的定价
• 在网页仪表板上提供收入和订单量分析
• 在网页仪表板中审核、退款或重新打印任何订单
• 支持本地化货币
• 无需服务器基础设施。我们为您处理从付款到印刷和邮寄的所有事宜

要求

• Xcode 10.2
• 以 iOS 10.0+ 为目标的部署

安装

CocoaPods

如果您使用的是 CocoaPods，只需将以下内容添加到您的 Podfile 中：

pod "Photobook"
pod 'PayPal-iOS-SDK/Core', '~> 2.18.0'

PayPal 功能虽然是可选的，但推荐使用，因为通常与它结合使用会有更高的转化率。

快速集成

我们真的意思是集成可以在几分钟内完成。

• 步骤 1: 导入 SDK

Objective-C

@import Photobook;

Swift

import Photobook

• 步骤 2: 设置 API 键和环境

Objective-C

[[PhotobookSDK shared] setEnvironment:EnvironmentLive]; // Or EnvironmentTest for testing
[[PhotobookSDK shared] setKiteApiKey:@"YOUR_API_KEY"];

Swift

PhotobookSDK.shared.environment = .live // Or .test for testing
PhotobookSDK.shared.kiteApiKey = "YOUR_API_KEY"

• 步骤 3: 设置 3D Secure 2 支付

有关 SCA（强客户身份验证）要求的详细信息，请参阅此处。

将 URL Scheme 添加到您的 info.plist 中

<key>CFBundleURLTypes</key>
<array>
	<dict>
		<key>CFBundleURLSchemes</key>
		<array>
			<string>myappname123456</string>
		</array>
	</dict>
</array>

将您定义的 URL Scheme 传递给 Photobook SDK

Objective-C

[[PhotobookSDK shared] setKiteUrlScheme:@"myappname123456"];

Swift

PhotobookSDK.shared.kiteUrlScheme = "myappname123456"

在您的应用程序代理中实现以下方法

Objective-C

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
	return [[PhotobookSDK shared] handleUrlCallBack:url];   
}

Swift

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
   	return PhotobookSDK.shared.handleUrlCallBack(with: url)
}

• 步骤 4: 创建并呈现 Photobook SDK ViewController

Objective-C

PhotobookAsset *asset = [[PhotobookAsset alloc] initWithUrl:[NSURL URLWithString:@"https://psps.s3.amazonaws.com/sdk_static/4.jpg"] size:CGSizeMake(1034, 1034)];
    
    UIViewController *vc = [[PhotobookSDK shared] photobookViewControllerWith:@[asset] embedInNavigation:YES delegate:nil completion:^(UIViewController *controller, BOOL success){
        [source dismissViewControllerAnimated:YES completion:NULL];
    }];
    
    [self presentViewController:vc animated:YES completion:NULL];

Swift

let asset = PhotobookAsset(withUrl: URL(string: "https://psps.s3.amazonaws.com/sdk_static/4.jpg"), size: CGSize(width: 1034, height: 1034))
guard let photobookViewController = PhotobookSDK.shared.photobookViewController(with: [asset], completion: { [weak welf = self] (viewController, success) in
    source.navigationController?.popToRootViewController(animated: true)
}) else { return }
present(photobookViewController, animated: true, completion: nil)

• 步骤 5: 🎉盈利🎉

💰💵💶💷💴

凭证与环境

您的移动应用程序集成需要对每个环境（实时和测试（沙盒））的不同 API 密钥值。

您可以在开发仪表板的 凭证 部分找到这些 Kite API 凭证。

沙盒

您的Sandbox API密钥可用于向我们的服务器提交测试打印订单。这些订单将不会打印和邮寄，但您可以将打印SDK集成到应用中而不产生费用。在开发和测试过程中，您希望主要使用沙箱环境来避免实际金钱的流动。要测试沙箱支付，您可以使用自己的PayPal沙箱账户或通过以下链接联系我们：[email protected]

当您准备好测试端到端打印和邮寄过程；在您提交应用至App Store之前，您需要将您的实际API密钥替换进去。

实际

您的实际API密钥用于提交打印订单至我们的服务器，这些订单将被打印并邮寄至指定的收件人。实际订单需要支付真实货币。这一费用通常转嫁给最终用户（虽然这并不是必须的，如果您想自己承担，也可以这样做）。

登录至我们的开发者仪表板允许您动态更改最终用户价格，即您想要从每个订单中获得的收入。支持多种货币支付，使您能够轻松将价格本地化给您的用户。仪表板还提供打印订单量和您所赚得的钱的概述。

ApplePay

如果您想启用通过ApplePay付款，请参阅我们的ApplePay设置文档。

许可证

Photobook SDK在修改后的MIT许可证下可用。有关更多信息，请参阅LICENSE文件。