获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Tạo liên kết động với Unity

Bạn có thể tạo Liên kết động ngắn hoặc dài bằng API liên kết động Firebase. API có một số cấu trúc tham số tùy chọn để xây dựng liên kết. Các liên kết ngắn cũng có thể được tạo từ một liên kết dài đã được tạo trước đó. API liên kết động sẽ tạo một URL như sau:

https://example.page.link/aSDf

Trước khi bắt đầu

Trước khi có thể sử dụng Liên kết động Firebase , bạn cần:

  • Đăng ký dự án Unity của bạn và định cấu hình dự án đó để sử dụng Firebase.

    • Nếu dự án Unity của bạn đã sử dụng Firebase, thì dự án đó đã được đăng ký và định cấu hình cho Firebase.

    • Nếu bạn không có dự án Unity, bạn có thể tải xuống một ứng dụng mẫu .

  • Thêm SDK Unity Firebase (cụ thể là FirebaseDynamicLinks.unitypackage ) vào dự án Unity của bạn.

Lưu ý rằng việc thêm Firebase vào dự án Unity của bạn liên quan đến các tác vụ trong bảng điều khiển Firebase và trong dự án Unity đang mở của bạn (ví dụ: bạn tải xuống tệp cấu hình Firebase từ bảng điều khiển, sau đó chuyển chúng vào dự án Unity của bạn).

Đặt tiền tố URI liên kết động

  1. Trong bảng điều khiển Firebase, hãy mở phần Liên kết động .

  2. Nếu bạn chưa chấp nhận các điều khoản dịch vụ và đặt tiền tố URI cho Liên kết động của mình, hãy làm như vậy khi được nhắc.

    Nếu bạn đã có tiền tố URI liên kết động, hãy lưu ý đến nó. Bạn cần cung cấp tiền tố URI liên kết động khi bạn tạo Liên kết động theo chương trình.

  3. Khuyến nghị : Chỉ định các mẫu URL được phép trong các liên kết sâu và liên kết dự phòng của bạn. Bằng cách làm như vậy, bạn ngăn các bên trái phép tạo Liên kết động chuyển hướng từ miền của bạn đến các trang web mà bạn không kiểm soát. Xem các mẫu URL danh sách trắng .

Sử dụng bảng điều khiển Firebase

Nếu bạn muốn tạo một Liên kết động duy nhất, cho mục đích thử nghiệm hoặc để nhóm tiếp thị của bạn dễ dàng tạo một liên kết có thể được sử dụng trong một thứ gì đó như bài đăng trên mạng xã hội, thì cách đơn giản nhất là truy cập bảng điều khiển Firebase và tạo một liên kết theo cách thủ công theo biểu mẫu từng bước.

Miền tùy chỉnh

Bạn có thể kiểm soát tốt hơn thương hiệu Liên kết động của mình bằng cách sử dụng miền của riêng bạn thay vì miền phụ goo.gl hoặc page.link . Làm theo các hướng dẫn sau để thiết lập miền tùy chỉnh cho dự án của bạn.

Sử dụng API liên kết động Firebase

Tạo một Liên kết động dài từ các tham số

Để tạo Liên kết động, hãy tạo đối tượng DynamicLinkComponents , đặt bất kỳ thành viên tùy chọn nào cho cấu hình bổ sung, sau đó truy cập thuộc tính LongDynamicLink để lấy URL liên kết.

Ví dụ tối thiểu sau đây tạo một Liên kết động dài đến https://www.example.com/ mở bằng ứng dụng Android của bạn com.example.android trên Android và ứng dụng com.example.ios trên iOS:

var components = new Firebase.DynamicLinks.DynamicLinkComponents(
    // The base Link.
    new System.Uri("https://www.example.com/"),
    // The dynamic link URI prefix.
    "https://example.page.link") {
      IOSParameters = new Firebase.DynamicLinks.IOSParameters("com.example.ios"),
      AndroidParameters = new Firebase.DynamicLinks.AndroidParameters(
        "com.example.android.package_name"),
    };
// do something with: components.LongDynamicLink

Tạo một liên kết động ngắn

Để tạo một Liên kết động ngắn, hãy chuyển một liên kết dài đã tạo trước đó tới Firebase.DynamicLinks.GetShortLinkAsync hoặc xây dựng DynamicLinkComponents theo cách tương tự như trên.

GetShortLinkAsync tùy chọn có thêm thông số cấu hình DynamicLinkOptions với thuộc tính PathLength , cho phép bạn kiểm soát cách tạo liên kết. Việc tạo liên kết ngắn yêu cầu một yêu cầu mạng tới phần phụ trợ Firebase, do đó, phương thức GetShortLinkAsync được thực thi không đồng bộ. GetShortLinkAsync trả về Task<Firebase.DynamicLinks.ShortDynamicLink> .

Ví dụ:

var options = new Firebase.DynamicLinks.DynamicLinkOptions {
  PathLength = DynamicLinkPathLength.Unguessable
};

Firebase.DynamicLinks.DynamicLinks.GetShortLinkAsync(components, options).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("GetShortLinkAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("GetShortLinkAsync encountered an error: " + task.Exception);
    return;
  }

  // Short Link has been created.
  Firebase.DynamicLinks.ShortDynamicLink link = task.Result;
  Debug.LogFormat("Generated short link {0}", link.Url);

  var warnings = new System.Collections.Generic.List<string>(link.Warnings);
  if (warnings.Count > 0) {
    // Debug logging for warnings generating the short link.
  }
});

Ví dụ trên sử dụng biểu thức lambda được kích hoạt khi nhiệm vụ hoàn thành.