您可以使用 Firebase Dynamic Links API 建立短或長的 Dynamic Links。API 會使用數種選用參數結構來建立連結。您也可以透過先前產生的長連結建立短連結。Dynamic Links API 會產生如下的網址:
https://example.page.link/aSDf
事前準備
使用 Firebase 動態連結前,您必須先:
註冊 Unity 專案,並將其設定為使用 Firebase。
如果您的 Unity 專案已使用 Firebase,表示該專案已完成註冊並設定 Firebase。
如果您沒有 Unity 專案,可以下載範例應用程式。
在 Unity 專案中新增 Firebase Unity SDK (尤其是
FirebaseDynamicLinks.unitypackage
)。
請注意,將 Firebase 新增至 Unity 專案涉及到 Firebase 主控台和開放式 Unity 專案中的工作 (例如從主控台下載 Firebase 設定檔,再移至 Unity 專案)。
設定 Dynamic Links URI 前置字串
在 Firebase 控制台中開啟「Dynamic Links」部分。
如果您尚未接受服務條款,並且為動態連結設定 URI 前置字串,請在系統提示時進行。
如果您已經有 Dynamic Links URI 前置字串,請加以記下。當您透過程式輔助方式建立 Dynamic Links 時,必須提供 Dynamic Links URI 前置字串。
建議:指定深層連結和備用連結允許的網址模式。這樣一來,就能防止未經授權的對象建立動態連結,將該網域重新導向到由您控管的網站。請參閱「將網址模式加入許可清單」。
使用 Firebase 控制台
如果您想產生單一動態連結 (無論是為了測試目的,或是要讓行銷團隊輕鬆建立可用於社群媒體貼文等項目的連結),最簡單的方法就是造訪 Firebase 主控台,然後按照逐步表單手動建立。
自訂網域
您可以使用您自己的網域 (而非 goo.gl
或 page.link
子網域),進一步控管 Dynamic Link 的品牌。請按照這些操作說明為專案設定自訂網域。
Info.plist
使用 Firebase Dynamic Links API
根據參數建立較長的動態連結
如要建立動態連結,請建立 DynamicLinkComponents
物件,為其他設定設定任何選用成員,然後存取 LongDynamicLink
屬性取得連結網址。
以下最簡單的範例會建立指向 https://www.example.com/ 的長動態連結,這會在 Android 裝置上透過 Android 應用程式 com.example.android 和 iOS 上的應用程式 com.example.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
建立簡短動態連結
如要建立短版動態連結,請將先前產生的長連結傳遞至 Firebase.DynamicLinks.GetShortLinkAsync
,或按照上述方式建構 DynamicLinkComponents
。
GetShortLinkAsync
可選擇使用帶有 PathLength
屬性的額外 DynamicLinkOptions
設定參數,以便控制連結產生方式。如要產生短連結,需要向 Firebase 後端發出網路要求,因此 GetShortLinkAsync
方法會以非同步方式執行。GetShortLinkAsync
會傳回 Task<Firebase.DynamicLinks.ShortDynamicLink>
。
例如:
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. } });
上述範例使用的 lambda 運算式會在工作完成時觸發。