ข้ามไปที่เนื้อหา

iOS

หน้านี้แนะนำการกำหนดค่าการตรวจสอบสิทธิ์ SDK iOS ของแบรนด์ Hive

การเพิ่มฟีเจอร์

เพิ่ม กรอบฟีเจอร์การตรวจสอบสิทธิ์ ลงใน Podfile ในไดเรกทอรีโปรเจกต์ของคุณ เพียงเพิ่มฟีเจอร์การตรวจสอบสิทธิ์ที่คุณต้องการใช้

ในการใช้ บริการจัดการอุปกรณ์ ให้เพิ่มเฟรมเวิร์กต่อไปนี้:

pod 'HiveDeviceManagement', $HIVE_SDK_VERSION # Framework for managing the devices of app users

ในการใช้ Google Recaptcha สำหรับการเข้าสู่ระบบของแขก ให้เพิ่มกรอบงานต่อไปนี้:

pod 'HiveGoogleRecaptcha', $HIVE_SDK_VERSION # Framework for using the Google recaptcha enterprise feature based on bot scores during guest login

ตามระเบียบข้อบังคับ เช่น [ประกาศเกี่ยวกับการจัดการการติดเกมออนไลน์ของเยาวชนอย่างเข้มงวดเพิ่มเติม] ที่ประกาศโดยการบริหารงานสื่อและการเผยแพร่แห่งชาติของจีน เพื่อใช้ฟีเจอร์ที่ต้องการการตรวจสอบชื่อจริงสำหรับผู้ใช้ที่เข้าถึงจากจีนเฉพาะสำหรับเกมที่ได้รับใบอนุญาตเกมจากจีนเท่านั้น ให้เพิ่มกรอบงานต่อไปนี้:

pod 'HiveRealNameVerification', $HIVE_SDK_VERSION # Real-name verification service added


หลังจากบันทึก Podfile ด้วยเฟรมเวิร์กที่คุณต้องการใช้แล้ว ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งเฟรมเวิร์กในโปรเจกต์ของคุณ:

pod install

การเพิ่ม IdP

เพิ่ม IdP frameworks ลงใน Podfile ในไดเรกทอรีโปรเจกต์ของคุณ เพียงเพิ่ม IdP ที่คุณต้องการใช้


ด้านล่างเป็นตัวอย่างของการเพิ่มเฟรมเวิร์กเพื่อใช้ใน Podfile ในไดเรกทอรีโปรเจกต์ของคุณ ฟีเจอร์ การเข้าสู่ระบบแขก สามารถใช้ได้โดยไม่ต้องเพิ่มเฟรมเวิร์ก

pod 'HiveAuthV4ProviderAppleSignIn', $HIVE_SDK_VERSION # Signin with Apple login
pod 'HiveAuthV4ProviderFacebook', $HIVE_SDK_VERSION # Facebook idp, social Facebook feature
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 # Membership login, Hive SDK Social feature
pod 'HiveAuthV4ProviderWeverse', $HIVE_SDK_VERSION # Weverse 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 or above)

หลังจากบันทึก Podfile ด้วยเฟรมเวิร์กที่คุณต้องการใช้แล้ว ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งเฟรมเวิร์กในโปรเจกต์ของคุณ:

pod install

การตั้งค่าเพิ่มเติมโดย IdP

การตั้งค่าเพิ่มเติมจำเป็นต้องมีขึ้นอยู่กับ IdP.

การตั้งค่า Signin ด้วย Apple IdP

นี่คือคำแนะนำสำหรับการตั้งค่า Signin With Apple IdP ปฏิบัติตามขั้นตอนเหล่านี้เพื่อเพิ่มการเข้าสู่ระบบ Apple ลงในรายการ IdP ของคุณ

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Signing & Capabilities.
  4. คลิกที่ปุ่ม + Capability ที่มุมซ้ายบนของแท็บ Signing & Capabilities.
  5. เลือก Sign In with Apple จากรายการเพื่อเพิ่มมัน.

  6. คุณสามารถเห็นลงชื่อเข้าใช้ด้วย Appleที่เพิ่มเข้ามาในรายการ Signing & Capabilities

    ]

การตั้งค่า IdP ของ Apple Game Center

นี่คือคำแนะนำสำหรับการตั้งค่า Apple Game Center IdP ปฏิบัติตามขั้นตอนเหล่านี้เพื่อเพิ่มการเข้าสู่ระบบ Apple Game Center ลงในรายการ IdP ของคุณ

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Signing & Capabilities.
  4. คลิกที่ปุ่ม + Capability ที่มุมซ้ายบนของแท็บ Signing & Capabilities.
  5. เลือก GameCenter จากรายการเพื่อเพิ่มมัน.

  6. คุณสามารถเห็นGame Centerที่เพิ่มเข้ามาในรายการ Signing & Capabilities.

การตั้งค่า Facebook IdP

นี่คือคำแนะนำสำหรับการตั้งค่า Facebook IdP.

การป้อน Facebook AppID และ ClientToken

ทำตามคำแนะนำด้านล่างเพื่อป้อน Facebook AppID และ ClientToken ในโปรเจกต์ Xcode ของคุณ

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Info.
  4. คลิกที่รายการ Custom iOS Target Properties ในแท็บ Info และป้อน Facebook App ID ของคุณในคุณสมบัติ FacebookAppID.

    5. ตรวจสอบ FacebookClientToken ใน Facebook console App Dashboard โดยไปที่ Settings > Advanced > Security > Client Token. 6. คลิกที่ Custom iOS Target Properties ในแท็บ Info และป้อน FacebookClientToken ในคุณสมบัติ FacebookClientToken. 7. คลิกที่ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties. 8. ป้อน Facebook AppID ที่มี fb ต่อท้าย (ตัวอย่าง: fb012342478841523) ในฟิลด์ URL Schemes ของรายการ Additional url type properties.

การเพิ่มโครงการ Facebook ลงในรายการอนุญาต

ในการเพิ่ม Facebook Scheme ลงในรายการที่อนุญาต คุณสามารถใช้หน้าต่างโปรเจกต์หรือเพิ่มโค้ดโดยตรงลงในไฟล์ Info.plist

Note

เริ่มต้นตั้งแต่ iOS 9 การสลับไปยังแอปพลิเคชันภายนอกจะได้รับอนุญาตเฉพาะสำหรับ Schemes ที่เพิ่มลงในรายการที่อนุญาต ในสภาพแวดล้อม iOS 9 เมื่อผู้ใช้เข้าสู่ระบบ Facebook จากเกมของคุณ แพลตฟอร์ม Hive จะใช้ Safari View Controller เพื่อทำการเข้าสู่ระบบ Facebook ผ่าน Safari webview ดังนั้นการสลับจากแอปเกมไปยังแอป Facebook จะไม่เกิดขึ้น และการเข้าสู่ระบบสามารถดำเนินการได้โดยใช้เบราว์เซอร์ภายในแอป Facebook แนะนำให้คุณลงทะเบียน Facebook Scheme ในรายการที่อนุญาตโดยค่าเริ่มต้น ดูเอกสาร Facebook SDK

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Info.
  4. คลิก LSApplicationQueriesSchemes ในแท็บ Info, คลิกปุ่ม + และเพิ่มสอง Schemes ต่อไปนี้:
    • 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. คลิกที่ LSApplicationQueriesSchemes ในแท็บ Info, คลิกที่ปุ่ม + และเพิ่ม Schemes ต่อไปนี้:
    • mqqOpensdkSSoLogin
    • mqqopensdkapiV2
    • mqqopensdkapiV3
    • wtloginmqq2
    • mqq
    • mqqapi
    • mqqopensdknopasteboard
    • mqqopensdknopasteboardios16

คุณยังสามารถเพิ่มโค้ดต่อไปนี้โดยตรงในไฟล์ Info.plist ได้

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

การตั้งค่า VK IdP

นี่คือคำแนะนำในการตั้งค่า VK IdP

การเข้าสู่ VK AppID

ปฏิบัติตามคำแนะนำด้านล่างเพื่อป้อน VK AppID ในโปรเจกต์ Xcode ของคุณ

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Info.
  4. คลิกที่รายการ Custom iOS Target Properties ในแท็บ Info และเพิ่มข้อมูล VK (vkauthorize, vk-share, vk) ลงใน LSApplicationQueriesShcemes.
  5. คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
  6. ป้อน VK AppID พร้อมกับคำนำหน้า vk (ตัวอย่าง: Vk1231234) ในฟิลด์ URL Schemes ภายใต้รายการ Additional url type properties.

การตั้งค่า WeChat IdP

นี่คือคำแนะนำสำหรับการตั้งค่า WeChat IdP.

การเข้าสู่ระบบ WeChat appid

ทำตามคำแนะนำด้านล่างเพื่อป้อน WeChat AppID ในโปรเจกต์ Xcode ของคุณ

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Info.
  4. คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
  5. ป้อน Identifier: weixin, weixinULAPI, URL Schemes: APP_ID ในฟิลด์ URL Schemes ภายใต้รายการ Additional url type properties.
Note

เมื่อใช้ WeChat IdP และ Hive SDK โปรโมชั่นร่วมกัน คุณต้องสมัคร Universal Link.

การตั้งค่า Google IdP

นี่คือคำแนะนำสำหรับการตั้งค่า Google IdP.

การป้อนรหัสลูกค้าที่กลับด้าน

ปฏิบัติตามคำแนะนำด้านล่างเพื่อป้อน Reversed Client ID ในโปรเจกต์ Xcode ของคุณ

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Info.
  4. คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
  5. ป้อน Identifier เป็นช่องว่างและ URL Schemes เป็น reversed client ID ในฟิลด์ URL Schemes ภายใต้รายการ Additional url type properties.

การตั้งค่า Line IdP

นี่คือคำแนะนำสำหรับการตั้งค่า Line IdP

การแก้ไข podfile

เมื่อใช้ Line IdP คุณต้องเพิ่มเนื้อหาต่อไปนี้ลงในโค้ด post_install ใน Podfile ในไดเรกทอรีโปรเจกต์ของคุณ

post_install do |installer|
   installer.pods_project.targets.each do |target|
       target.build_configurations.each do |config|
            ...
            # Change pod project settings when using linesdkswift
           if ['LineSDKSwift'].include? target.name
               config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
           # Response to a code signing compilation error issue for cocoapods bundle targets that occurs in xcode 14
           elsif config.build_settings['WRAPPER_EXTENSION'] == 'bundle'
               config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'
           end
            ...
       end
   end
end

หลังจากบันทึก Podfile ที่แก้ไขตามด้านบนแล้ว ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งเฟรมเวิร์กในโปรเจกต์ของคุณ:

pod install

กำลังเข้าสู่ app bundle id

ปฏิบัติตามคำแนะนำด้านล่างเพื่อป้อน App Bundle ID ในโปรเจกต์ Xcode ของคุณ

  1. เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
  2. เลือกแอปของคุณจากรายการ TARGETS.
  3. คลิกที่แท็บ Info.
  4. คลิกที่รายการ Custom iOS Target Properties ในแท็บ Info และเพิ่มข้อมูล LINE (lineauth2) ไปยัง LSApplicationQueriesShcemes.
  5. คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
  6. ป้อน ID แพ็คเกจแอปด้วยคำนำหน้า line3rdp (ตัวอย่าง: line3rdp.$(PRODUCT\_BUNDLE\_IDENTIFIER)) ในฟิลด์ URL Schemes ภายใต้รายการ Additional url type properties.
Warning

หลังจากที่คุณได้ดำเนินการฟีเจอร์การเข้าสู่ระบบ LINE แล้ว คุณต้องเพิ่มมันลงใน ข้อมูลสถานะการเชื่อมต่อ IdP.