跳轉至

iOS

Hive SDK 在 iOS 上使用認證功能的設定指南。

功能新增

在项目目录的 Podfile 中添加认证功能框架。仅添加您想要使用的认证功能。

要使用設備管理服務，請添加以下框架。

pod 'HiveDeviceManagement', $HIVE_SDK_VERSION # 앱 사용자의 기기 관리를 위한 프레임워크

要在訪客登錄中使用 Google Recaptcha，請添加以下框架。

pod 'HiveGoogleRecaptcha', $HIVE_SDK_VERSION # 게스트 로그인시 봇 점수 기반의 Google reCAPTCHA Enterprise 기능을 사용하기 위한 프레임워크

根據中國國家新聞出版署發布的[關於對未成年人在線遊戲成癮的更嚴格管理的通知]等相關規定，只有獲得中國版號的遊戲，才允許在中國接入的用戶進行實名認證功能，請添加以下框架。

pod 'HiveRealNameVerification', $HIVE_SDK_VERSION # 실명 인증 서비스 추가


保存添加了要使用的框架的 Podfile 后，执行以下命令以在项目中安装框架。

pod install

添加 IdP

在项目目录的 Podfile 中添加 IdP 框架。仅添加要使用的 IdP。


以下是向项目目录的 Podfile 添加框架的示例。即使不添加框架，访客登录 功能也可以使用。

pod 'HiveAuthV4ProviderAppleSignIn', $HIVE_SDK_VERSION # Signin with Apple 로그인
pod 'HiveAuthV4ProviderFacebook', $HIVE_SDK_VERSION # Facebook IdP, Social Facebook 기능
pod 'HiveAuthV4ProviderQQ', $HIVE_SDK_VERSION # QQ IdP
pod 'HiveAuthV4ProviderVK', $HIVE_SDK_VERSION # VK IdP
pod 'HiveAuthV4ProviderWechat', $HIVE_SDK_VERSION # WeChat IdP
pod 'HiveAuthV4ProviderGoogle', $HIVE_SDK_VERSION # Google IdP
pod 'HiveAuthV4ProviderAppleGameCenter', $HIVE_SDK_VERSION # Apple Game Center IdP
pod 'HiveAuthV4ProviderHive', $HIVE_SDK_VERSION # Hive 멤버십 로그인, Social Hive 기능
pod 'HiveAuthV4ProviderWeverse', $HIVE_SDK_VERSION # Weverse IdP
pod 'HiveAuthV4ProviderSteam', $HIVE_SDK_VERSION # Steam IdP
pod 'HiveAuthV4ProviderX', $HIVE_SDK_VERSION # X IdP

使用Line IDP時，如果目標為iOS 13以下，則僅需添加以下框架。

pod 'HiveAuthV4ProviderLine', $HIVE_SDK_VERSION # LINE IdP

如果是 iOS 13 或更高版本，请添加以下框架。

pod 'HiveAuthV4ProviderLine', $HIVE_SDK_VERSION # LINE IdP
pod 'HiveAuthV4ProviderLine/LineSDKSwift11', $HIVE_SDK_VERSION # LINE IdP(5.11.0 / iOS 13 이상)

在保存了添加了要使用的框架的 Podfile 后，执行以下命令以在项目中安装框架。

pod install

IdP的額外設定

根據IdP需要進行額外的設置。

使用 Apple IdP 登入設定

這裡是使用Signin With Apple IdP的設置指南。請按照以下步驟將Apple登錄添加到IdP列表中。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Signing & Capabilities 选项卡。
  4. 点击 Signing & Capabilities 选项卡左上角的 + Capability 按钮。

  5. 从列表中选择 Sign In with Apple 进行添加。

    6. 可以在 Signing & Capabilities 列表中找到使用 Apple 登录。

    Apple Game Center IdP 設定

以下是使用Apple Game Center IdP的設置指南。請按照以下步驟將Apple Game Center登錄添加到IdP列表中。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Signing & Capabilities 选项卡。
  4. 点击 Signing & Capabilities 选项卡左上角的 + Capability 按钮。

  5. 从列表中选择 GameCenter 进行添加。

  6. 可以在 Signing & Capabilities 列表中找到添加的 Game Center。

Facebook IdP 設定

本指南是為了使用Facebook IdP的設置。

輸入 Facebook AppID 和 ClientToken

請按照以下指示在 Xcode 專案中輸入 Facebook AppID 和 ClientToken。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Info 选项卡。

  4. 在 Info 选项卡中点击 Custom iOS Target Properties 项目，并在 FacebookAppID 属性中输入 Facebook 应用 ID。

    5. Facebook 控制台 应用仪表板中进入 设置 > 高级 > 安全 > 客户端令牌 以确认 FacebookClientToken。 6. 点击 Info 标签中的 Custom iOS Target Properties 项，输入 FacebookClientToken 到 FacebookClientToken 属性中。 7. 点击 Info 标签中的 URL Types 项，然后点击 + 图标以创建 Additional url type properties 项。 8. 在 Additional url type properties 项的 URL Schemes 栏中输入附加 fb 的 Facebook AppID（例如：fb012342478841523）。

將 Facebook Scheme 添加到白名單

要將 Facebook Scheme 添加到白名單中，可以使用項目窗口或直接在 Info.plist 文件中添加代碼。

Note

從 iOS 9 開始，只有在白名單中添加的 Scheme 才允許切換到外部應用。在 iOS 9 環境中，當用戶在您的遊戲中登錄 Facebook 時，Hive 平台利用 Safari 視圖控制器進行 Facebook 登錄，因此不會發生從遊戲應用切換到 Facebook 應用，而是通過應用內的瀏覽器處理登錄。Facebook 建議將 Facebook Scheme 默認登錄到白名單中。 查看 Facebook SDK 文檔

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Info 选项卡。
  4. 点击 Info 选项卡中的 LSApplicationQueriesSchemes，然后点击 + 按钮添加以下两个 Scheme。
    • fbapi
    • fb-messenger-share-api


也可以直接在Info.plist中添加以下代码。

"LSApplicationQueriesSchemes" : [
 "fbapi", 
 "fb-messenger-share-api"
]

QQ IdP 設定

本指南将指导您如何使用QQ IdP进行设置。

將 QQ 計劃添加到白名單

要將QQ Scheme添加到白名單，可以使用項目窗口或直接在Info.plist文件中添加代碼。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Info 标签。
  4. 点击 Info 标签的 LSApplicationQueriesSchemes，然后点击 + 按钮添加以下 Scheme。
    • mqqOpensdkSSoLogin
    • mqqopensdkapiV2
    • mqqopensdkapiV3
    • wtloginmqq2
    • mqq
    • mqqapi
    • mqqopensdknopasteboard
    • mqqopensdknopasteboardios16

可以直接在Info.plist中添加以下代码。

"LSApplicationQueriesSchemes" : [
 "mqqOpensdkSSoLogin",
 "mqqopensdkapiV2",
 "mqqopensdkapiV3",
 "wtloginmqq2",
 "mqq",
 "mqqapi"
]

VK IdP 設定

這裡是使用VK IdP的設置指南。

輸入 VK AppID

請按照以下指示在 Xcode 項目中輸入 VK AppID。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用程序。
  3. 点击 Info 标签。
  4. 在 Info 标签中的 Custom iOS Target Properties 项目中点击并添加 VK 数据到 LSApplicationQueriesSchemes（vkauthorize, vk-share, vk）。
  5. 点击 Info 标签中的 URL Types 项目，然后点击 + 图标以创建 Additional url type properties 项目。
  6. 在 Additional url type properties 项目下的 URL Schemes 字段中输入带有 vk 前缀的 VK AppID（例如：Vk1231234）。

WeChat IdP 設定

我們將指導您如何設置 WeChat IdP。

輸入 WeChat AppID

請按照以下指示在 Xcode 項目中輸入 WeChat AppID。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Info 标签。
  4. 点击 Info 标签中的 URL Types 项目，然后点击 + 图标以创建 Additional url type properties 项目。
  5. 在 Additional url type properties 项目下的 URL Schemes 字段中输入 Identifier: weixin、weixinULAPI 和 URL Schemes: APP_ID。
Note

使用 WeChat IdP 和 Hive SDK 促销时，必须应用 Universal Link。

Google IdP 設定

提供使用Google IdP的設定指南。

輸入反向客戶端 ID

請按照以下指示在 Xcode 項目中輸入反向客戶端 ID。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Info 选项卡。
  4. 点击 Info 选项卡中的 URL Types 项目，然后点击 + 图标以创建 Additional url type properties 项目。
  5. 在 Additional url type properties 项目下的 URL Schemes 字段中，Identifier 处理为空格，URL Schemes 输入 reversed client ID。

Line IdP 設定

這裡是使用Line IdP的設定指南。

修改 Podfile

使用 Line IdP 的話，必須在專案目錄的 Podfile post\_install 代碼中添加以下內容。

post_install do |installer|
   installer.pods_project.targets.each do |target|
       target.build_configurations.each do |config|
            ...
            # LineSDKSwift 사용 시 pod project 설정 변경필요
           if ['LineSDKSwift'].include? target.name
               config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
           # Xcode 14 에서 발생하는 CocoaPods bundle 타겟에 대한 Code signing 컴파일 에러 이슈 대응
           elsif config.build_settings['WRAPPER_EXTENSION'] == 'bundle'
               config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'
           end
            ...
       end
   end
end

在保存修改后的 Podfile 后，执行以下命令以在项目中安装框架。

pod install

輸入應用程式包 ID

請按照以下指示在 Xcode 項目中輸入應用程式包 ID。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Info 标签。
  4. 在 Info 标签中的 Custom iOS Target Properties 项目中，点击并添加 LINE 数据 (lineauth2) 到 LSApplicationQueriesSchemes。
  5. 在 Info 标签中的 URL Types 项目中，点击 + 图标以创建 Additional url type properties 项目。
  6. 在 Additional url type properties 项目下的 URL Schemes 字段中，输入添加了 line3rdp 前缀的应用程序包 ID（例如：line3rdp.$(PRODUCT\_BUNDLE\_IDENTIFIER)）。
Warning

实现 LINE 登录功能后，必须在 IdP 连接状态信息 中也添加。

X IdP 設定

提供使用 X IdP 的設置指南。

輸入應用程式包 ID

請按照以下指示在 Xcode 項目中輸入應用程式包 AppID。

  1. 在 Xcode 项目窗口的项目导航器中选择您的项目。
  2. 在 TARGETS 列表中选择您的应用。
  3. 点击 Info 标签。
  4. 点击 Info 标签中的 URL Types 项目，然后点击 + 图标以创建 Additional url type properties 项目。
  5. 在 Additional url type properties 项目下的 URL Schemes 字段中输入带有 hive.x 前缀的应用程序包 ID（例如：hive.x.$(PRODUCT\_BUNDLE\_IDENTIFIER)）。