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
pod 'HiveAuthV4ProviderTelegram', $HIVE_SDK_VERSION # Telegram 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でのサインイン設定¶

Apple IdPでサインインするための設定を案内します。以下の手順に従って、IdPリストにAppleでのログインを追加します。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Signing & Capabilitiesタブをクリックしてください。
Signing & Capabilitiesタブの左上にある+ Capabilityボタンをクリックしてください。
リストからSign In with Appleを選択して追加します。

6. Signing & Capabilities のリストに追加された Sign In with Apple を確認できます。

Apple Game Center IdP 設定¶

Apple Game Center IdPを使用するための設定を案内します。以下の手順に従ってIdPリストにApple Game Centerログインを追加します。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Signing & Capabilitiesタブをクリックしてください。
Signing & Capabilitiesタブの左上にある+ Capabilityボタンをクリックしてください。
リストからGameCenterを選択して追加します。
Signing & Capabilities のリストに追加された Game Center を確認できます。

Facebook IdPの設定¶

Facebook IdPを使用するための設定を案内します。

Facebook AppIDとClientTokenの入力¶

以下の案内に従って、XcodeプロジェクトにFacebook AppIDとClientTokenを入力します。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Infoタブをクリックしてください。
Infoタブ内のCustom iOS Target Properties項目をクリックし、FacebookAppIDプロパティにFacebook App 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から、外部アプリに切り替える際にはホワイトリストに追加されたスキームに対してのみ切り替えが許可されます。iOS 9環境でユーザーがあなたのゲームからFacebookにログインする際、HiveプラットフォームはSafariビューコントローラーを活用して、SafariウェブビューでFacebookログインを行います。そのため、ゲームアプリからFacebookアプリへの切り替えは発生せず、アプリ内部のブラウザを利用してログインを処理することができます。FacebookはホワイトリストにFacebookスキームを基本的に登録することを推奨しています。Facebook SDKドキュメントを見る

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Infoタブをクリックしてください。
InfoタブのLSApplicationQueriesSchemesをクリックし、+ボタンをクリックして次の2つのスキームを追加してください。
- fbapi
- fb-messenger-share-api

Info.plistに以下のコードを直接追加する方法もあります。

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

QQ IdP 設定¶

QQ IdPを使用するための設定を案内します。

QQスキームをホワイトリストに追加¶

QQ Schemeをホワイトリストに追加するには、プロジェクトウィンドウを使用するか、Info.plistファイルにコードを直接追加する方法があります。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストであなたのアプリを選択してください。
Infoタブをクリックしてください。
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を入力します。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Infoタブをクリックしてください。
Infoタブ内のCustom iOS Target Properties項目をクリックし、LSApplicationQueriesSchemesにVKデータを追加してください（vkauthorize, vk-share, vk）。
Infoタブ内のURL Types項目をクリックし、+アイコンをクリックしてAdditional url type properties項目を作成してください。
Additional url type properties項目の下のURL Schemesフィールドにvkプレフィックスを追加したVK AppID（例: Vk1231234）を入力してください。

WeChat IdP 設定¶

WeChat IdPを使用するための設定を案内します。

WeChat AppIDの入力¶

以下の案内に従って、XcodeプロジェクトにWeChat AppIDを入力します。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Infoタブをクリックしてください。
Infoタブ内のURL Types項目をクリックした後、+アイコンをクリックしてAdditional url type properties項目を作成してください。
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プロジェクトにReversed Client IDを入力します。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Infoタブをクリックしてください。
Infoタブ内のURL Types項目をクリックした後、+アイコンをクリックしてAdditional url type properties項目を作成してください。
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を入力してください。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Infoタブをクリックしてください。
Infoタブ内のCustom iOS Target Properties項目をクリックし、LSApplicationQueriesSchemesにLINEデータ（lineauth2）を追加してください。
Infoタブ内のURL Types項目をクリックした後、+アイコンをクリックしてAdditional url type properties項目を作成してください。
Additional url type properties項目の下のURL Schemesフィールドに、line3rdpプレフィックスを追加したアプリバンドルID（例: line3rdp.$(PRODUCT\_BUNDLE\_IDENTIFIER)）を入力してください。

Warning

LINEでログイン機能を実装した後、IdP連携状態情報にも必ず追加する必要があります。

X IdP 設定¶

X IdPを使用するための設定を案内します。

アプリバンドルIDの入力¶

以下の案内に従って、XcodeプロジェクトでアプリバンドルAppIDを入力してください。

Xcodeプロジェクトウィンドウのプロジェクトナビゲーターで、あなたのプロジェクトを選択してください。
TARGETSリストからあなたのアプリを選択してください。
Infoタブをクリックしてください。
Infoタブ内のURL Types項目をクリックし、+アイコンをクリックしてAdditional url type properties項目を作成してください。
Additional url type properties項目の下のURL Schemesフィールドにhive.xプレフィックスを追加したアプリバンドルID（例: hive.x.$(PRODUCT\_BUNDLE\_IDENTIFIER)）を入力してください。

iOS

機能追加¶

IdPの追加¶

IdPごとの追加設定¶

Apple IdPでのサインイン設定¶

Apple Game Center IdP 設定¶

Facebook IdPの設定¶

Facebook AppIDとClientTokenの入力¶

Facebook Schemeをホワイトリストに追加¶

QQ IdP 設定¶

QQスキームをホワイトリストに追加¶

VK IdP 設定¶

VK AppIDの入力¶

WeChat IdP 設定¶

WeChat AppIDの入力¶

Google IdP 設定¶

逆転クライアントIDの入力¶

Line IdP 設定¶

Podfileの修正¶

アプリバンドルIDの入力¶

X IdP 設定¶

アプリバンドルIDの入力¶