iOS
หน้านี้แนะนำการกำหนดค่าการตรวจสอบสิทธิ์ SDK iOS ของแบรนด์ Hive
การเพิ่มฟีเจอร์¶
เพิ่ม กรอบฟีเจอร์การตรวจสอบสิทธิ์ ลงใน Podfile ในไดเรกทอรีโปรเจกต์ของคุณ เพียงเพิ่มฟีเจอร์การตรวจสอบสิทธิ์ที่คุณต้องการใช้
ในการใช้ บริการจัดการอุปกรณ์ ให้เพิ่มเฟรมเวิร์กต่อไปนี้:
ในการใช้ Google Recaptcha สำหรับการเข้าสู่ระบบของแขก ให้เพิ่มกรอบงานต่อไปนี้:
pod 'HiveGoogleRecaptcha', $HIVE_SDK_VERSION # Framework for using the Google recaptcha enterprise feature based on bot scores during guest login
ตามระเบียบข้อบังคับ เช่น [ประกาศเกี่ยวกับการจัดการการติดเกมออนไลน์ของเยาวชนอย่างเข้มงวดเพิ่มเติม] ที่ประกาศโดยการบริหารงานสื่อและการเผยแพร่แห่งชาติของจีน เพื่อใช้ฟีเจอร์ที่ต้องการการตรวจสอบชื่อจริงสำหรับผู้ใช้ที่เข้าถึงจากจีนเฉพาะสำหรับเกมที่ได้รับใบอนุญาตเกมจากจีนเท่านั้น ให้เพิ่มกรอบงานต่อไปนี้:
หลังจากบันทึก Podfile ด้วยเฟรมเวิร์กที่คุณต้องการใช้แล้ว ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งเฟรมเวิร์กในโปรเจกต์ของคุณ:
การเพิ่ม 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 ให้เพิ่มเฟรมเวิร์กต่อไปนี้เท่านั้น:
หากเป็น 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 ด้วยเฟรมเวิร์กที่คุณต้องการใช้แล้ว ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งเฟรมเวิร์กในโปรเจกต์ของคุณ:
การตั้งค่าเพิ่มเติมโดย IdP¶
การตั้งค่าเพิ่มเติมจำเป็นต้องมีขึ้นอยู่กับ IdP.
การตั้งค่า Signin ด้วย Apple IdP¶
นี่คือคำแนะนำสำหรับการตั้งค่า Signin With Apple IdP ปฏิบัติตามขั้นตอนเหล่านี้เพื่อเพิ่มการเข้าสู่ระบบ Apple ลงในรายการ IdP ของคุณ
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Signing & Capabilities.
- คลิกที่ปุ่ม + Capability ที่มุมซ้ายบนของแท็บ Signing & Capabilities.
-
เลือก Sign In with Apple จากรายการเพื่อเพิ่มมัน.
-
คุณสามารถเห็นลงชื่อเข้าใช้ด้วย Appleที่เพิ่มเข้ามาในรายการ Signing & Capabilities
การตั้งค่า IdP ของ Apple Game Center¶
นี่คือคำแนะนำสำหรับการตั้งค่า Apple Game Center IdP ปฏิบัติตามขั้นตอนเหล่านี้เพื่อเพิ่มการเข้าสู่ระบบ Apple Game Center ลงในรายการ IdP ของคุณ
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Signing & Capabilities.
- คลิกที่ปุ่ม + Capability ที่มุมซ้ายบนของแท็บ Signing & Capabilities.
-
เลือก GameCenter จากรายการเพื่อเพิ่มมัน.
-
คุณสามารถเห็นGame Centerที่เพิ่มเข้ามาในรายการ Signing & Capabilities.
การตั้งค่า Facebook IdP¶
นี่คือคำแนะนำสำหรับการตั้งค่า Facebook IdP.
การป้อน Facebook AppID และ ClientToken¶
ทำตามคำแนะนำด้านล่างเพื่อป้อน Facebook AppID และ ClientToken ในโปรเจกต์ Xcode ของคุณ
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Info.
-
คลิกที่รายการ 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
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Info.
- คลิก LSApplicationQueriesSchemes ในแท็บ Info, คลิกปุ่ม + และเพิ่มสอง Schemes ต่อไปนี้:
- fbapi
- fb-messenger-share-api
คุณยังสามารถเพิ่มโค้ดต่อไปนี้โดยตรงลงในไฟล์ Info.plist ได้
การตั้งค่า QQ IdP¶
นี่คือคำแนะนำสำหรับการตั้งค่า QQ IdP.
การเพิ่มแผน QQ ลงในรายการที่อนุญาต¶
ในการเพิ่ม QQ Scheme ลงในรายการอนุญาต คุณสามารถใช้หน้าต่างโปรเจกต์หรือเพิ่มโค้ดโดยตรงลงในไฟล์ Info.plist
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Info.
- คลิกที่ 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 ของคุณ
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Info.
- คลิกที่รายการ Custom iOS Target Properties ในแท็บ Info และเพิ่มข้อมูล VK (
vkauthorize
,vk-share
,vk
) ลงใน LSApplicationQueriesShcemes. - คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
- ป้อน VK AppID พร้อมกับคำนำหน้า vk (ตัวอย่าง:
Vk1231234
) ในฟิลด์ URL Schemes ภายใต้รายการ Additional url type properties.
การตั้งค่า WeChat IdP¶
นี่คือคำแนะนำสำหรับการตั้งค่า WeChat IdP.
การเข้าสู่ระบบ WeChat appid¶
ทำตามคำแนะนำด้านล่างเพื่อป้อน WeChat AppID ในโปรเจกต์ Xcode ของคุณ
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Info.
- คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
- ป้อน 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 ของคุณ
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Info.
- คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
- ป้อน 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 ที่แก้ไขตามด้านบนแล้ว ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งเฟรมเวิร์กในโปรเจกต์ของคุณ:
กำลังเข้าสู่ app bundle id¶
ปฏิบัติตามคำแนะนำด้านล่างเพื่อป้อน App Bundle ID ในโปรเจกต์ Xcode ของคุณ
- เลือกโปรเจกต์ของคุณจากตัวนำทางโปรเจกต์ในหน้าต่างโปรเจกต์ Xcode.
- เลือกแอปของคุณจากรายการ TARGETS.
- คลิกที่แท็บ Info.
- คลิกที่รายการ Custom iOS Target Properties ในแท็บ Info และเพิ่มข้อมูล LINE (
lineauth2
) ไปยัง LSApplicationQueriesShcemes. - คลิกที่รายการ URL Types ในแท็บ Info จากนั้นคลิกที่ไอคอน + เพื่อสร้างรายการ Additional url type properties.
- ป้อน ID แพ็คเกจแอปด้วยคำนำหน้า
line3rdp
(ตัวอย่าง:line3rdp.$(PRODUCT\_BUNDLE\_IDENTIFIER)
) ในฟิลด์ URL Schemes ภายใต้รายการ Additional url type properties.
Warning
หลังจากที่คุณได้ดำเนินการฟีเจอร์การเข้าสู่ระบบ LINE แล้ว คุณต้องเพิ่มมันลงใน ข้อมูลสถานะการเชื่อมต่อ IdP.