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

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

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

ตั้งค่า Firebase และ SDK ลิงก์แบบไดนามิก

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

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

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

   flutter pub add firebase_dynamic_links
   

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

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

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

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

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

      โปรดดูที่อนุญาตรูปแบบ 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);

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

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