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¶

เพิ่ม IdP Framework ใน Podfile ของไดเรกทอรีโปรเจกต์ ใช้เฉพาะ 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

การตั้งค่า Signin With 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. คุณสามารถตรวจสอบ Sign In with Apple ที่ถูกเพิ่มในรายการ Signing & Capabilities ได้

   

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

นี่คือคำแนะนำในการตั้งค่า IdP สำหรับ Apple Game Center กรุณาทำตามขั้นตอนด้านล่างเพื่อเพิ่มการเข้าสู่ระบบ 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. ไปที่ Facebook คอนโซล แผงควบคุมแอป และเข้าไปที่ การตั้งค่า > ขั้นสูง > ความปลอดภัย > โทเค็นไคลเอนต์ เพื่อตรวจสอบ FacebookClientToken 6. คลิกที่ Custom iOS Target Properties ในแท็บ Info และกรอก FacebookClientToken ในคุณสมบัติ FacebookClientToken 7. คลิกที่ URL Types ในแท็บ Info แล้วคลิกที่ไอคอน + เพื่อสร้าง คุณสมบัติเพิ่มเติมของประเภท URL 8. ในช่อง URL Schemes ของคุณสมบัติเพิ่มเติมของประเภท URL ให้กรอก Facebook AppID ที่มี fb ต่อท้าย (ตัวอย่าง: fb012342478841523)

   

เพิ่ม Facebook Scheme ในรายการที่อนุญาต¶

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

1. ในหน้าต่างโปรเจกต์ Xcode ให้เลือกโปรเจกต์ของคุณจากโปรเจกต์ Navigator
2. ในรายการ TARGETS ให้เลือกแอปของคุณ
3. คลิกที่แท็บ Info
4. คลิกที่ LSApplicationQueriesSchemes ในแท็บ Info และคลิกปุ่ม + เพื่อเพิ่ม Scheme สองตัวต่อไปนี้
   • fbapi
   • fb-messenger-share-api

มีวิธีการเพิ่มโค้ดด้านล่างนี้โดยตรงใน Info.plist

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

การตั้งค่า QQ IdP¶

ขอแนะนำการตั้งค่าเพื่อใช้ QQ IdP

เพิ่ม QQ Scheme ลงในรายการที่อนุญาต¶

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

1. ในหน้าต่างโปรเจกต์ Xcode ให้เลือกโปรเจกต์ของคุณจากโปรเจกต์เนวิเกเตอร์
2. ในรายการ TARGETS ให้เลือกแอปของคุณ
3. คลิกที่แท็บ Info
4. คลิกที่ LSApplicationQueriesSchemes ในแท็บ Info และคลิกที่ปุ่ม + เพื่อเพิ่ม Scheme ต่อไปนี้
   • 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 ลงใน LSApplicationQueriesSchemes (vkauthorize, vk-share, vk)
5. คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties
6. ในฟิลด์ URL Schemes ใต้รายการ Additional url type properties ให้ป้อน VK AppID ที่มีพรีฟิก vk (ตัวอย่าง: Vk1231234)

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

ขอแนะนำการตั้งค่าเพื่อใช้ WeChat IdP

ป้อน AppID ของ WeChat¶

โปรดป้อน WeChat AppID ในโปรเจ็กต์ Xcode ตามคำแนะนำด้านล่าง

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

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

ขอแนะนำการตั้งค่าเพื่อใช้ Google IdP

การป้อน ID ลูกค้าที่ย้อนกลับ¶

กรุณาป้อน Reversed Client ID ในโปรเจ็กต์ Xcode ตามคำแนะนำด้านล่าง

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

การตั้งค่า 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|
            ...
            # 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 แพ็คเกจแอป¶

กรุณาป้อน ID แพ็คเกจแอปในโปรเจ็กต์ Xcode ตามคำแนะนำด้านล่าง

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

การตั้งค่า X IdP¶

ขอแนะนำการตั้งค่าเพื่อใช้ X IdP

ป้อน ID แพ็คเกจแอป¶

โปรดป้อน AppID ของแอปในโครงการ Xcode ตามคำแนะนำด้านล่าง

1. เลือกโปรเจกต์ของคุณจากโปรเจกต์เนวิเกเตอร์ในหน้าต่างโปรเจกต์ Xcode
2. เลือกแอปของคุณจากรายการ TARGETS
3. คลิกที่แท็บ Info
4. คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties
5. ในฟิลด์ URL Schemes ใต้รายการ Additional url type properties ให้ป้อน ID แพ็คเกจแอปที่เพิ่มพรีฟิก hive.x (ตัวอย่าง: hive.x.$(PRODUCT\_BUNDLE\_IDENTIFIER))