สร้างลิงก์แบบไดนามิกในแอป Flutter

คุณสามารถสร้างลิงก์แบบไดนามิกแบบสั้นหรือแบบยาวได้ด้วย Firebase Dynamic Links Builder API API นี้ยอมรับทั้งลิงก์ไดนามิกแบบยาวหรืออ็อบเจ็กต์ที่มีพารามิเตอร์ลิงก์ไดนามิก และส่งคืน URL ดังตัวอย่างต่อไปนี้:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

ตั้งค่า Firebase และ Dynamic Links SDK

ก่อนที่คุณจะสามารถสร้างลิงก์แบบไดนามิกในแอป Android คุณต้องรวม Firebase SDK หากแอปของคุณได้รับการตั้งค่าให้รับลิงก์แบบไดนามิก แสดงว่าคุณได้ดำเนินการตามขั้นตอนเหล่านี้แล้ว และคุณสามารถข้ามส่วนนี้ได้

1. ติดตั้งและเริ่มต้น Firebase SDK สำหรับ Flutter หากคุณยังไม่ได้ดำเนินการ

2. จากไดเร็กทอรีรูทของโปรเจ็กต์ Flutter ให้รันคำสั่งต่อไปนี้เพื่อติดตั้งปลั๊กอิน Dynamic Links:

   flutter pub add firebase_dynamic_links
   

3. หากคุณกำลังสร้างแอป Android ให้เปิดหน้า การตั้งค่าโครงการ ของคอนโซล Firebase และตรวจสอบว่าคุณได้ระบุคีย์การลงนาม SHA-1 แล้ว หากคุณใช้ App Links ให้ระบุคีย์ SHA-256 ของคุณด้วย

4. ในคอนโซล Firebase ให้เปิดส่วน ลิงก์แบบไดนามิก

   1. หากคุณยังไม่ได้ตั้งค่าโดเมนสำหรับลิงก์แบบไดนามิก ให้คลิกปุ่ม เริ่มต้นใช้งาน และปฏิบัติตามคำแนะนำ

      หากคุณมีโดเมน Dynamic Links อยู่แล้ว โปรดจดบันทึกไว้ คุณต้องระบุโดเมนลิงก์แบบไดนามิกเมื่อคุณสร้างลิงก์แบบไดนามิกโดยทางโปรแกรม

   2. แนะนำ : จากเมนู "เพิ่มเติม" (⋮) ให้ระบุรูปแบบ URL ที่อนุญาตในลิงก์ในรายละเอียดและลิงก์สำรอง การทำเช่นนี้เป็นการป้องกันไม่ให้บุคคลที่ไม่ได้รับอนุญาตสร้างลิงก์แบบไดนามิกที่เปลี่ยนเส้นทางจากโดเมนของคุณไปยังไซต์ที่คุณไม่ได้ควบคุม

      ดู อนุญาตรูปแบบ URL เฉพาะ

สร้างลิงก์แบบไดนามิกจากพารามิเตอร์

หากต้องการสร้างลิงก์แบบไดนามิก ให้สร้างวัตถุ DynamicLinkParameters ใหม่และส่งต่อไปยัง buildLink() หรือ buildShortLink()

ตัวอย่างขั้นต่ำต่อไปนี้สร้างลิงก์แบบไดนามิกยาวไปยัง https://www.example.com/ ที่เปิดด้วย com.example.app.android บน Android และแอป com.example.app.ios บน iOS:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);

หากต้องการสร้างลิงก์แบบไดนามิกแบบสั้น ให้ส่งอ็อบเจ็กต์ DynamicLinkParameters ไปยัง buildShortLink() การสร้างลิงค์สั้น ๆ นั้นต้องการการโทรผ่านเครือข่าย ตัวอย่างเช่น:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

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

อย่างไรก็ตาม หากลิงก์สั้นของคุณนำไปสู่ข้อมูลเฉพาะของผู้ใช้ คุณควรสร้างลิงก์ที่ยาวขึ้นโดยมีคำต่อท้าย 17 อักขระ ซึ่งทำให้ไม่น่าจะมีคนเดาลิงก์ไดนามิกที่ถูกต้องได้ ในการทำเช่นนั้น ให้ส่ง ShortDynamicLinkType.unguessable ไปยังเมธอด buildShortLink() :

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

พารามิเตอร์ลิงก์ไดนามิก

คุณสามารถใช้ Dynamic Link Builder API เพื่อสร้างลิงก์แบบไดนามิกด้วยพารามิเตอร์ที่รองรับ ดู การอ้างอิง API

ตัวอย่างต่อไปนี้สร้างลิงก์แบบไดนามิกด้วยชุดพารามิเตอร์ทั่วไปหลายชุด:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(
    packageName: "com.example.app.android",
    minimumVersion: 30,
  ),
  iosParameters: const IOSParameters(
    bundleId: "com.example.app.ios",
    appStoreId: "123456789",
    minimumVersion: "1.0.1",
  ),
  googleAnalyticsParameters: const GoogleAnalyticsParameters(
    source: "twitter",
    medium: "social",
    campaign: "example-promo",
  ),
  socialMetaTagParameters: SocialMetaTagParameters(
    title: "Example of a Dynamic Link",
    imageUrl: Uri.parse("https://example.com/image.png"),
  ),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

คุณสามารถตั้งค่าพารามิเตอร์ Dynamic Link ด้วยวิธีการต่อไปนี้:

https://example.com/link
https://example.page.link