Catch up on everthing we announced at this year's Firebase Summit. Learn more

با Firebase Remote Config شروع به کار کنید

می توانید از Firebase Remote Config برای تعریف پارامترها در برنامه خود و به روز رسانی مقادیر آنها در فضای ابری استفاده کنید و به شما امکان می دهد ظاهر و رفتار برنامه خود را بدون توزیع به روز رسانی برنامه تغییر دهید.

کتابخانه Remote Config برای ذخیره مقادیر پارامترهای پیش‌فرض درون برنامه، واکشی مقادیر پارامترهای به‌روزرسانی شده از باطن Remote Config و کنترل زمانی که مقادیر واکشی شده در دسترس برنامه شما قرار می‌گیرد، استفاده می‌شود. برای کسب اطلاعات بیشتر، نگاه کنید به استراتژی بارگذاری پیکربندی از راه دور .

این راهنما شما را از طریق مراحل برای شروع و برخی از نمونه کد فراهم می کند، که همه آنها در دسترس است به کلون کردن و یا دانلود از است فایربیس / شروع سریع وحدت گیتهاب مخزن.

Remote Config را به برنامه خود اضافه کنید

قبل از اینکه شما می توانید استفاده کنید از راه دور پیکربندی ، شما نیاز به:

  • پروژه Unity خود را ثبت کرده و آن را برای استفاده از Firebase پیکربندی کنید.

    • اگر پروژه Unity شما قبلاً از Firebase استفاده می‌کند، پس از قبل برای Firebase ثبت و پیکربندی شده است.

    • اگر شما یک پروژه وحدت را نداشته باشند، شما می توانید یک دانلود برنامه نمونه .

  • اضافه کردن فایربیس وحدت SDK (به طور خاص، FirebaseRemoteConfig.unitypackage ) به طرح وحدت خود را.

توجه داشته باشید که اضافه کردن فایربیس به پروژه وحدت خود را شامل وظایف هر دو در فایربیس کنسول و در پروژه های وحدت باز خود را (به عنوان مثال، شما دانلود فایل های پیکربندی فایربیس از کنسول، و سپس حرکت آنها را در پروژه وحدت خود را).

مقادیر پارامترهای پیش‌فرض درون برنامه را تنظیم کنید

می‌توانید مقادیر پارامترهای پیش‌فرض را در شی Remote Config تنظیم کنید تا در صورتی که هیچ مقدار دیگری از backend بازیابی نشده باشد، استفاده شود. این به برنامه شما اجازه می‌دهد تا قبل از اتصال به پشتیبان Remote Config همانطور که در نظر گرفته شده رفتار کند.

برای انجام این کار، یک فرهنگ لغت رشته ایجاد کنید و آن را با جفت های کلید/مقدار پر کنید که نشان دهنده پیش فرض هایی است که می خواهید اضافه کنید. (خواص غیر رشته خواهد شد به نوع ملک وقتی تبدیل SetDefaultsAsync() نامیده می شود).

System.Collections.Generic.Dictionary<string, object> defaults =
  new System.Collections.Generic.Dictionary<string, object>();

// These are the values that are used if we haven't fetched data from the
// server
// yet, or if we ask for values that the server doesn't have:
defaults.Add("config_test_string", "default local string");
defaults.Add("config_test_int", 1);
defaults.Add("config_test_float", 1.0);
defaults.Add("config_test_bool", false);

Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.SetDefaultsAsync(defaults)
  .ContinueWithOnMainThread(task => {

مقادیر پارامتر را برای استفاده در برنامه خود دریافت کنید

اکنون می توانید مقادیر پارامتر را از شی Remote Config دریافت کنید. اگر مقادیری را در Remote Config تنظیم کنید، آنها را واکشی کرده و سپس فعال کنید، این مقادیر برای برنامه شما در دسترس هستند. در غیر این صورت، شما در در برنامه مقادیر پارامتر با استفاده از پیکربندی از SetDefaultsAsync() .

برای به دست آوردن این ارزش ها، استفاده از GetValue() ، ارائه کلید پارامتر به عنوان آرگومان. این تابع یک ConfigValue ، که دارای خواص برای تبدیل ارزش به انواع پایه های مختلف.

برنامه خود را در کنسول Firebase وصل کنید

در فایربیس کنسول ، اضافه کردن برنامه های خود را به پروژه فایربیس خود را.

مقادیر پارامتر را تنظیم کنید

  1. در فایربیس کنسول ، باز کردن پروژه شما.
  2. انتخاب کنید از راه دور پیکربندی از منوی به نمایش داشبورد پیکربندی از راه دور.
  3. پارامترهایی را با همان نام پارامترهایی که در برنامه خود تعریف کرده اید تعریف کنید. برای هر پارامتر، می توانید یک مقدار پیش فرض (که در نهایت مقدار پیش فرض درون برنامه را لغو می کند) و مقادیر شرطی تنظیم کنید. برای کسب اطلاعات بیشتر، نگاه کنید به پارامترهای راه دور پیکربندی و شرایط .

واکشی و فعال کردن مقادیر (در صورت نیاز)

به بهانه مقادیر پارامتر از باطن پیکربندی از راه دور، پاسخ FetchAsync() روش. هر مقداری که در باطن تنظیم می‌کنید در شی Remote Config واکشی و ذخیره می‌شود.

// Start a fetch request.
// FetchAsync only fetches new data if the current data is older than the provided
// timespan.  Otherwise it assumes the data is "recent enough", and does nothing.
// By default the timespan is 12 hours, and for production apps, this is a good
// number. For this example though, it's set to a timespan of zero, so that
// changes in the console will always show up immediately.
public Task FetchDataAsync() {
  DebugLog("Fetching data...");
  System.Threading.Tasks.Task fetchTask =
  Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.FetchAsync(
      TimeSpan.Zero);
  return fetchTask.ContinueWithOnMainThread(FetchComplete);
}

ارزش ها از طریق ذهن FetchAsync() به صورت محلی ذخیره سازی هنگامی که واکشی کامل، اما نه تا زمانی که در دسترس ساخته شده ActivateFetched() فراخوانی می شود. از آنجا که FetchAsync() را اجرا غیر همزمان، این شما را قادر به اطمینان حاصل شود که مقادیر جدید اواسط محاسبه، و یا در زمان های دیگر که ممکن است مشکلات و یا رفتار عجیب و غریب باعث اعمال نمی شود.

(اختیاری) حالت توسعه دهنده را فعال کنید

برای فعال کردن حالت توسعه، که می توان به گرفتن گلوگاه غیر فعال کردن در طول توسعه استفاده می شود، شما می توانید با استفاده از FirebaseRemoteConfig.Setting اموال، تنظیم یک جدید ConfigSettings با IsDeveloperMode مجموعه ای به درست است.

مراحل بعدی

اگر شما در حال حاضر، کشف راه دور پیکربندی موارد استفاده ، و نگاهی به برخی از مفاهیم کلیدی و پیشرفته مستندات استراتژی، از جمله: