অন-ডিভাইস ব্যক্তিগতকরণ বিকাশকারী নির্দেশিকা,অন-ডিভাইস ব্যক্তিগতকরণ বিকাশকারী নির্দেশিকা,অন-ডিভাইস ব্যক্তিগতকরণ বিকাশকারী নির্দেশিকা

অন-ডিভাইস ব্যক্তিগতকরণ (ODP) অ্যাপ্লিকেশন থেকে শেষ ব্যবহারকারীদের তথ্য রক্ষা করার জন্য ডিজাইন করা হয়েছে। অ্যাপ্লিকেশনগুলি শেষ ব্যবহারকারীদের জন্য তাদের পণ্য এবং পরিষেবাগুলি কাস্টমাইজ করতে ODP ব্যবহার করে, তবে তারা ব্যবহারকারীর জন্য তৈরি করা সঠিক কাস্টমাইজেশনগুলি দেখতে সক্ষম হবে না (যদি না অ্যাপ্লিকেশন এবং শেষ ব্যবহারকারীর মধ্যে ODP এর বাইরে সরাসরি মিথস্ক্রিয়া না থাকে)। মেশিন লার্নিং মডেল বা পরিসংখ্যানগত বিশ্লেষণ সহ অ্যাপ্লিকেশনগুলির জন্য, ওডিপি যথাযথ ডিফারেনশিয়াল প্রাইভেসি মেকানিজম ব্যবহার করে সঠিকভাবে বেনামী করা হয়েছে তা নিশ্চিত করার জন্য পরিষেবা এবং অ্যালগরিদমের একটি সেট সরবরাহ করে। আরও বিশদ বিবরণের জন্য, অন-ডিভাইস ব্যক্তিগতকরণের ব্যাখ্যাকারী দেখুন।

ODP একটি IsolatedProcess বিকাশকারী কোড চালায় যার নেটওয়ার্ক, স্থানীয় ডিস্ক বা ডিভাইসে চলমান অন্যান্য পরিষেবাগুলিতে সরাসরি অ্যাক্সেস নেই তবে নিম্নলিখিত স্থানীয়ভাবে স্থায়ী ডেটা উত্সগুলিতে অ্যাক্সেস রয়েছে:

• RemoteData - প্রযোজ্য হলে দূরবর্তী, বিকাশকারী পরিচালিত ব্যাকএন্ড থেকে ডাউনলোড করা অপরিবর্তনীয় কী-মান ডেটা।
• LocalData - পরিবর্তনযোগ্য কী-মানের ডেটা স্থানীয়ভাবে বিকাশকারীর দ্বারা স্থায়ী হয়, যদি প্রযোজ্য হয়।
• UserData - প্ল্যাটফর্ম দ্বারা প্রদত্ত ব্যবহারকারীর ডেটা।

নিম্নলিখিত আউটপুট সমর্থিত:

• ক্রমাগত আউটপুট: এই আউটপুটগুলি ভবিষ্যতের স্থানীয় প্রক্রিয়াকরণে ব্যবহার করা যেতে পারে, প্রদর্শিত আউটপুট তৈরি করতে, ফেডারেটেড লার্নিং সুবিধাপ্রাপ্ত মডেল প্রশিক্ষণ, বা ফেডারেটেড অ্যানালিটিক্স সুবিধাযুক্ত ক্রস-ডিভাইস পরিসংখ্যান বিশ্লেষণে।
  • বিকাশকারীরা স্থানীয় REQUESTS টেবিলে অনুরোধের পাশাপাশি তাদের প্রক্রিয়াকরণের ফলাফল লিখতে পারে।
  • বিকাশকারীরা EVENTS টেবিলে পূর্বের অনুরোধের সাথে যুক্ত অতিরিক্ত ডেটা লিখতে পারে।
• প্রদর্শিত আউটপুট:
  • বিকাশকারীরা এইচটিএমএল ফেরত দিতে পারে যা ODP দ্বারা একটি SurfaceView ভিতরে WebView রেন্ডার করা হয়। সেখানে রেন্ডার করা বিষয়বস্তু ইনভোকিং অ্যাপের কাছে দৃশ্যমান হবে না।
  • ডেভেলপাররা রেন্ডার করা HTML এর সাথে ব্যবহারকারীর ইন্টারঅ্যাকশনের লগিং এবং প্রক্রিয়াকরণ ট্রিগার করতে HTML আউটপুটের মধ্যে ODP-প্রদত্ত ইভেন্ট URL এম্বেড করতে পারে। ODP সেই URL গুলির অনুরোধগুলিকে বাধা দেয় এবং EVENTS টেবিলে লেখা ডেটা তৈরি করতে কোড আহ্বান করে৷

ক্লায়েন্ট অ্যাপ এবং SDKগুলি ODP API ব্যবহার করে একটি SurfaceView এ HTML সামগ্রী প্রদর্শন করতে ODP-কে আহ্বান করতে পারে৷ একটি SurfaceView রেন্ডার করা সামগ্রী কলিং অ্যাপে দৃশ্যমান নয়৷ ক্লায়েন্ট অ্যাপ বা SDK ওডিপির সাথে বিকাশকারী একটি থেকে আলাদা সত্তা হতে পারে।

ODP পরিষেবা ক্লায়েন্ট অ্যাপ পরিচালনা করে যেটি তার UI-এর মধ্যে ব্যক্তিগতকৃত সামগ্রী দেখানোর জন্য ODP-কে আহ্বান করতে চায়। এটি ডেভেলপারের প্রদত্ত এন্ডপয়েন্ট থেকে কন্টেন্ট ডাউনলোড করে এবং ডাউনলোড করা ডেটার পোস্টপ্রসেসিংয়ের জন্য যুক্তি যোগায়। এটি IsolatedProcess এবং অন্যান্য পরিষেবা এবং অ্যাপগুলির মধ্যে সমস্ত যোগাযোগের মধ্যস্থতা করে৷

ক্লায়েন্ট অ্যাপগুলি একটি IsolatedProcess চলমান বিকাশকারীর কোডের সাথে ইন্টারঅ্যাক্ট করতে OnDevicePersonalizationManager ক্লাসে পদ্ধতিগুলি ব্যবহার করে৷ IsolatedProcess এ চলমান বিকাশকারীর কোড IsolatedService ক্লাসকে প্রসারিত করে এবং IsolatedWorker ইন্টারফেস প্রয়োগ করে। IsolatedService প্রতিটি অনুরোধের জন্য IsolatedWorker এর একটি উদাহরণ তৈরি করতে হবে।

নিম্নলিখিত চিত্রটি OnDevicePersonalizationManager এবং IsolatedWorker এর পদ্ধতিগুলির মধ্যে সম্পর্ক দেখায়।

OnDevicePersonalizationManager এবং IsolatedWorker মধ্যে সম্পর্কের চিত্র।

একটি ক্লায়েন্ট অ্যাপ IsolatedService নামে execute পদ্ধতি ব্যবহার করে ODP কল করে। ODP পরিষেবাটি IsolatedWorker এর onExecute পদ্ধতিতে কল ফরওয়ার্ড করে। IsolatedWorker স্থির থাকার রেকর্ড এবং প্রদর্শনের বিষয়বস্তু ফেরত দেয়। ODP পরিষেবা REQUESTS বা EVENTS টেবিলে অবিরাম আউটপুট লিখে, এবং ক্লায়েন্ট অ্যাপে প্রদর্শিত আউটপুটে একটি অস্বচ্ছ রেফারেন্স প্রদান করে। ক্লায়েন্ট অ্যাপটি এই অস্বচ্ছ রেফারেন্সটি ভবিষ্যতের requestSurfacePackage কলে ব্যবহার করতে পারে তার UI এর মধ্যে যে কোনও প্রদর্শন সামগ্রী প্রদর্শন করতে।

অবিরাম আউটপুট

ডেভেলপারের onExecute রিটার্নের বাস্তবায়নের পরে ওডিপি পরিষেবাটি REQUESTS সারণীতে একটি রেকর্ড বজায় রাখে। REQUESTS টেবিলের প্রতিটি রেকর্ডে ODP পরিষেবা দ্বারা উত্পন্ন কিছু সাধারণ প্রতি-অনুরোধের ডেটা রয়েছে এবং Rows একটি তালিকা ফেরত দেওয়া হয়েছে৷ প্রতিটি Row (key, value) জোড়ার একটি তালিকা রয়েছে। প্রতিটি মান একটি স্কেলার, স্ট্রিং বা ব্লব। সাংখ্যিক মানগুলি একত্রিত হওয়ার পরে রিপোর্ট করা যেতে পারে এবং স্থানীয় বা কেন্দ্রীয় ডিফারেনশিয়াল গোপনীয়তা প্রয়োগ করার পরে স্ট্রিং বা ব্লব ডেটা রিপোর্ট করা যেতে পারে। বিকাশকারীরা পরবর্তী ব্যবহারকারীর ইন্টারঅ্যাকশন ইভেন্টগুলি EVENTS টেবিলে লিখতে পারে— EVENTS টেবিলের প্রতিটি রেকর্ড REQUESTS টেবিলের একটি সারির সাথে যুক্ত। ODP পরিষেবা স্বচ্ছভাবে প্রতিটি রেকর্ডের সাথে একটি টাইমস্ট্যাম্প এবং কলিং অ্যাপের প্যাকেজ নাম এবং ODP বিকাশকারীর APK লগ করে।

আপনি শুরু করার আগে

আপনি ODP এর সাথে বিকাশ শুরু করার আগে, আপনাকে আপনার প্যাকেজ ম্যানিফেস্ট সেট আপ করতে হবে এবং বিকাশকারী মোড সক্ষম করতে হবে।

প্যাকেজ ম্যানিফেস্ট সেটিংস

ODP ব্যবহার করার জন্য নিম্নলিখিতগুলি প্রয়োজন:

1. AndroidManifest.xml এ একটি <property> ট্যাগ যা ODP কনফিগারেশন তথ্য ধারণকারী প্যাকেজের একটি XML সংস্থানকে নির্দেশ করে।
2. AndroidManifest.xml এ একটি <service> ট্যাগ যা IsolatedService প্রসারিত করে এমন ক্লাসকে চিহ্নিত করে, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে। <service> ট্যাগের পরিষেবাটিতে অবশ্যই exported গুণাবলী থাকতে হবে এবং isolatedProcess true সেট করতে হবে।
3. XML রিসোর্সে একটি <service> ট্যাগ যা ধাপ 1-এ নির্দিষ্ট করা হয়েছে যা ধাপ 2 থেকে পরিষেবা শ্রেণীকে চিহ্নিত করে। <service> ট্যাগকে অবশ্যই ট্যাগের ভিতরে অতিরিক্ত ODP-নির্দিষ্ট সেটিংস অন্তর্ভুক্ত করতে হবে, যেমনটি দ্বিতীয় উদাহরণে দেখানো হয়েছে।

AndroidManifest.xml

<!-- Contents of AndroidManifest.xml -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.example.odpsample" >
    <application android:label="OdpSample">
        <!-- XML resource that contains other ODP settings. -->
        <property android:name="android.ondevicepersonalization.ON_DEVICE_PERSONALIZATION_CONFIG"
                  android:resource="@xml/OdpSettings"></property>
        <!-- The service that ODP binds to. -->
        <service android:name="com.example.odpsample.SampleService"
                android:exported="true" android:isolatedProcess="true" />
    </application>
</manifest>

XML রিসোর্সে ODP-নির্দিষ্ট ম্যানিফেস্ট

<property> ট্যাগে নির্দিষ্ট করা XML রিসোর্স ফাইলটিকে অবশ্যই একটি <service> ট্যাগে পরিষেবা শ্রেণী ঘোষণা করতে হবে, এবং URL এন্ডপয়েন্ট উল্লেখ করতে হবে যেখান থেকে ODP RemoteData সারণী পূরণ করতে সামগ্রী ডাউনলোড করবে, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনি যদি ফেডারেটেড কম্পিউট বৈশিষ্ট্যগুলি ব্যবহার করেন তবে আপনাকে ফেডারেটেড কম্পিউট সার্ভারের ইউআরএল এন্ডপয়েন্টও নির্দিষ্ট করতে হবে যেখানে ফেডারেটেড কম্পিউট ক্লায়েন্ট সংযোগ করবে।

<!-- Contents of res/xml/OdpSettings.xml -->
<on-device-personalization>
   <!-- Name of the service subclass -->
   <service name="com.example.odpsample.SampleService">
     <!-- If this tag is present, ODP will periodically poll this URL and
          download content to populate REMOTE_DATA. Developers that do not need to
          download content from their servers can skip this tag. -->
     <download-settings url="https://example.com/get" />
     <!-- If you want to use federated compute feature to train a model, you
          need to specify this tag. -->
     <federated-compute-settings url="https://fcpserver.example.com/" />
   </service>
</on-device-personalization>

বিকাশকারী মোড সক্ষম করুন৷

অ্যান্ড্রয়েড স্টুডিও ডকুমেন্টেশনের বিকাশকারী বিকল্পগুলি সক্ষম করুন বিভাগে নির্দেশাবলী অনুসরণ করে বিকাশকারী মোড সক্ষম করুন৷

সুইচ এবং ফ্ল্যাগ সেটিংস

ODP-তে সুইচ এবং পতাকার একটি সেট রয়েছে যা নির্দিষ্ট কার্যকারিতা নিয়ন্ত্রণ করতে ব্যবহৃত হয়:

• _global_kill সুইচ : সমস্ত ODP বৈশিষ্ট্যের জন্য বিশ্বব্যাপী সুইচ; ODP ব্যবহার করতে মিথ্যা সেট করুন
• _federated_compute_kill_switch: _ ODP-এর সমস্ত প্রশিক্ষণ (ফেডারেটেড লার্নিং) কার্যকারিতা নিয়ন্ত্রণকারী সুইচ; প্রশিক্ষণ ব্যবহার করার জন্য মিথ্যা সেট করুন
• _caller_app_allow তালিকা : ODP কে কল করার অনুমতি দেওয়া হয়েছে তা নিয়ন্ত্রণ করে, অ্যাপগুলি (pkg নাম, [ঐচ্ছিক] শংসাপত্র) এখানে যোগ করা যেতে পারে বা এটিকে * হিসাবে সেট করা যেতে পারে।
• _isolated_service_allow তালিকা : বিচ্ছিন্ন পরিষেবা প্রক্রিয়ায় কোন পরিষেবাগুলি চলতে পারে তা নিয়ন্ত্রণ করে।

আপনি সীমাবদ্ধতা ছাড়াই ODP ব্যবহার করতে সমস্ত সুইচ এবং পতাকা কনফিগার করতে নিম্নলিখিত কমান্ডগুলি চালাতে পারেন:

# Set flags and killswitches
adb shell device_config set_sync_disabled_for_tests persistent
adb shell device_config put on_device_personalization global_kill_switch false
adb shell device_config put on_device_personalization federated_compute_kill_switch false
adb shell device_config put on_device_personalization caller_app_allow_list \"*\"
adb shell device_config put on_device_personalization isolated_service_allow_list \"*\"

ডিভাইস-সাইড API

ODP এর জন্য Android API রেফারেন্স ডকুমেন্টেশন দেখুন।

IsolatedService সার্ভিসের সাথে মিথস্ক্রিয়া

IsolatedService ক্লাস হল একটি বিমূর্ত বেস ক্লাস যা ODP-এর বিরুদ্ধে বিকাশ করতে ইচ্ছুক সকল ডেভেলপারদের অবশ্যই প্রসারিত করতে হবে, এবং তাদের প্যাকেজ ম্যানিফেস্টে একটি বিচ্ছিন্ন প্রক্রিয়ায় চলছে বলে ঘোষণা করতে হবে। ODP পরিষেবা এই পরিষেবাটি একটি বিচ্ছিন্ন প্রক্রিয়ায় শুরু করে এবং এটির জন্য অনুরোধ করে৷ IsolatedService ODP পরিষেবা থেকে অনুরোধ গ্রহণ করে এবং অনুরোধটি পরিচালনা করার জন্য একটি IsolatedWorker তৈরি করে।

ক্লায়েন্ট অ্যাপের অনুরোধ, ডাউনলোড সমাপ্তি এবং রেন্ডার করা এইচটিএমএল দ্বারা ট্রিগার হওয়া ইভেন্টগুলি পরিচালনা করতে বিকাশকারীদের IsolatedWorker ইন্টারফেস থেকে পদ্ধতিগুলি প্রয়োগ করতে হবে। এই সমস্ত পদ্ধতিতে ডিফল্ট নো-অপ ইমপ্লিমেন্টেশন আছে, তাই ডেভেলপাররা তাদের আগ্রহী নয় এমন পদ্ধতিগুলি বাস্তবায়ন করা এড়িয়ে যেতে পারে।

OnDevicePersonalizationManager ক্লাস একটি বিচ্ছিন্ন প্রক্রিয়ায় চলমান একটি বিকাশকারী-বাস্তবায়িত IsolatedService সাথে ইন্টারঅ্যাক্ট করার জন্য অ্যাপ এবং SDK-এর জন্য একটি API প্রদান করে। নিম্নলিখিত কিছু উদ্দেশ্যমূলক ব্যবহারের ক্ষেত্রে রয়েছে:

সারফেসভিউতে প্রদর্শনের জন্য HTML সামগ্রী তৈরি করুন

প্রদর্শনের জন্য সামগ্রী তৈরি করতে, OnDevicePersonalizationManager#execute এর সাথে, কলিং অ্যাপটি একটি SurfaceView -তে রেন্ডার করার অনুরোধ করার জন্য পরবর্তী requestSurfacePackage কলে ফিরে আসা SurfacePackageToken অবজেক্ট ব্যবহার করতে পারে।

সফল হলে, রিসিভারকে একটি SurfacePackage সহ ওডিপি পরিষেবা দ্বারা রেন্ডার করা একটি দৃশ্যের জন্য ডাকা হয়। ক্লায়েন্ট অ্যাপ্লিকেশনগুলিকে তাদের ভিউ অনুক্রমের মধ্যে একটি SurfaceView এ SurfacePackage সন্নিবেশ করাতে হবে।

একটি অ্যাপ যখন একটি পূর্ববর্তী OnDevicePersonalizationManager#execute কল দ্বারা ফেরত একটি SurfacePackageToken সাহায্যে SurfacePackage কলের requestSurfacePackage করে তখন ODP পরিষেবাটি একটি বেড়াযুক্ত ফ্রেমের মধ্যে রেন্ডার করার জন্য HTML স্নিপেট আনতে IsolatedWorker#onRender কল করে৷ একজন ডেভেলপারের এই পর্যায়ে LocalData বা UserData এ অ্যাক্সেস থাকে না। এটি ডেভেলপারকে জেনারেট করা HTML-এ অ্যাসেট ফেচ URL-এর মধ্যে সম্ভাব্য সংবেদনশীল UserData এম্বেড করা থেকে বাধা দেয়। ডেভেলপাররা IsolatedService#getEventUrlProvider ব্যবহার করে ট্র্যাকিং ইউআরএল জেনারেট করা HTML-এ অন্তর্ভুক্ত করতে পারে। যখন HTML রেন্ডার করা হয়, তখন ODP পরিষেবা এই URL গুলির অনুরোধগুলিকে বাধা দেবে এবং IsolatedWorker#onEvent কল করবে। onRender() প্রয়োগ করার সময় কেউ getRemoteData() আহ্বান করতে পারে।

HTML সামগ্রীর মধ্যে ইভেন্ট ট্র্যাক করুন

EventUrlProvider ক্লাস ইভেন্ট ট্র্যাকিং URL তৈরি করতে API প্রদান করে যা ডেভেলপাররা তাদের HTML আউটপুটে অন্তর্ভুক্ত করতে পারে। HTML রেন্ডার করা হলে, ODP ইভেন্ট URL এর পেলোড সহ IsolatedWorker#onEvent আহ্বান করবে।

ODP পরিষেবা রেন্ডার করা HTML-এর মধ্যে ODP জেনারেট করা ইভেন্ট URL-এর অনুরোধগুলিকে বাধা দেয়, IsolatedWorker#onEvent কল করে এবং ফিরে আসা EventLogRecord টিকে EVENTS টেবিলে লগ করে।

অবিরাম ফলাফল লিখুন

OnDevicePersonalizationManager#execute এর সাথে, পরিষেবাটিতে স্থায়ী সঞ্চয়স্থানে ডেটা লেখার বিকল্প রয়েছে ( REQUESTS এবং EVENTS টেবিল)। এই সারণীগুলিতে কেউ লিখতে পারে এমন এন্ট্রিগুলি এখানে রয়েছে:

• একটি RequestLogRecord REQUESTS টেবিলে যোগ করতে হবে।
• EVENTS টেবিলে যোগ করার জন্য EventLogRecord বস্তুর একটি তালিকা, প্রতিটিতে পূর্বে লিখিত RequestLogRecord এ একটি পয়েন্টার রয়েছে।

ডিভাইসে সঞ্চয়স্থানে স্থায়ী ফলাফলগুলি মডেল প্রশিক্ষণের জন্য ফেডারেটেড লার্নিং দ্বারা গ্রাস করা যেতে পারে।

ডিভাইসে প্রশিক্ষণের কাজগুলি পরিচালনা করুন

ODP পরিষেবা IsolatedWorker#onTrainingExample কল করে যখন একটি ফেডারেটেড কম্পিউট প্রশিক্ষণের কাজ শুরু হয় এবং ODP গ্রহণকারী ডেভেলপারদের দ্বারা প্রদত্ত প্রশিক্ষণের উদাহরণ পেতে চায়। onTrainingExample() প্রয়োগ করার সময় আপনি getRemoteData() , getLocalData() , getUserData() এবং getLogReader() ব্যবহার করতে পারেন।

ফেডারেটেড কম্পিউট কাজের সময়সূচী বা বাতিল করতে, আপনি FederatedComputeScheduler ক্লাস ব্যবহার করতে পারেন যা সমস্ত ODP IsolatedService জন্য API প্রদান করে। প্রতিটি ফেডারেটেড কম্পিউট কাজ তার জনসংখ্যার নাম দ্বারা চিহ্নিত করা যেতে পারে।

আপনি একটি নতুন ফেডারেটেড কম্পিউট কাজের সময় নির্ধারণ করার আগে:

• রিমোট ফেডারেটেড কম্পিউট সার্ভারে এই জনসংখ্যা নামের একটি টাস্ক ইতিমধ্যেই তৈরি করা উচিত।
• ফেডারেটেড কম্পিউট সার্ভার ইউআরএল এন্ডপয়েন্ট ইতিমধ্যেই federated-compute-settings ট্যাগের সাথে প্যাকেজ ম্যানিফেস্ট সেটিংসে নির্দিষ্ট করা উচিত।

ক্রমাগত আউটপুট সঙ্গে মিথস্ক্রিয়া

নিম্নলিখিত বিভাগটি বর্ণনা করে কিভাবে ODP-তে স্থায়ী আউটপুটের সাথে ইন্টারঅ্যাক্ট করতে হয়।

স্থানীয় টেবিল পড়ুন

LogReader ক্লাস REQUESTS এবং EVENTS টেবিল পড়ার জন্য API প্রদান করে। এই সারণীগুলিতে এমন ডেটা রয়েছে যা onExecute() বা onEvent() কলের সময় IsolatedService দ্বারা লেখা হয়েছিল। এই সারণীগুলির ডেটা ফেডারেটেড লার্নিং সুবিধাপ্রাপ্ত মডেল প্রশিক্ষণ, বা ফেডারেটেড অ্যানালিটিক্স ফ্যাসিলিটেড ক্রস-ডিভাইস পরিসংখ্যান বিশ্লেষণের জন্য ব্যবহার করা যেতে পারে।

ডাউনলোড করা সামগ্রীর সাথে মিথস্ক্রিয়া

ODP-তে ডাউনলোড করা সামগ্রীর সাথে কীভাবে ইন্টারঅ্যাক্ট করতে হয় তা নিম্নলিখিত বিভাগে বর্ণনা করে৷

সার্ভার থেকে সামগ্রী ডাউনলোড করুন

ODP পরিষেবা পর্যায়ক্রমে IsolatedService এর প্যাকেজ ম্যানিফেস্টে ঘোষিত URL থেকে বিষয়বস্তু ডাউনলোড করে, এবং ডাউনলোড শেষ হওয়ার পরে onDownloadCompleted সম্পন্ন হলে কল করে। ডাউনলোড হল একটি JSON-ফাইল যাতে কী-মানের জোড়া রয়েছে৷

ODP গ্রহণকারী বিকাশকারীরা ডাউনলোড করা সামগ্রীর কোন উপসেটটি RemoteData টেবিলে যুক্ত করা উচিত এবং কোনটি বাদ দেওয়া উচিত তা চয়ন করতে পারেন। বিকাশকারীরা ডাউনলোড করা বিষয়বস্তু পরিবর্তন করতে পারে না - এটি নিশ্চিত করে যে RemoteData টেবিলে কোনো ব্যবহারকারীর ডেটা নেই। উপরন্তু, ডেভেলপাররা তাদের পছন্দ মতো LocalData সারণী তৈরি করতে বিনামূল্যে; উদাহরণস্বরূপ, তারা কিছু পূর্বনির্ধারিত ফলাফল ক্যাশে করতে পারে।

অনুরোধ বিন্যাস ডাউনলোড করুন

ওডিপি পর্যায়ক্রমে RemoteData সারণীতে কন্টেন্ট আনার জন্য ডেভেলপার প্যাকেজ ম্যানিফেস্টে ঘোষিত ইউআরএল এন্ডপয়েন্টকে পোল করে।

শেষ বিন্দু পরে বর্ণিত হিসাবে একটি JSON প্রতিক্রিয়া ফেরত প্রত্যাশিত. JSON প্রতিক্রিয়াতে অবশ্যই একটি syncToken থাকতে হবে যা প্রেরিত ডেটার সংস্করণকে চিহ্নিত করে, সাথে কী-মান জোড়ার তালিকা জনিত করা হবে। syncToken মানটি সেকেন্ডের মধ্যে একটি টাইমস্ট্যাম্প হতে হবে, একটি UTC ঘন্টার সীমানায় আটকানো। ডাউনলোডের অনুরোধের অংশ হিসেবে, ODP পূর্বে সম্পন্ন করা ডাউনলোডের syncToken এবং ডাউনলোড URL-এ সিঙ্কটোকেন এবং দেশের প্যারামিটার হিসেবে ডিভাইসের দেশ প্রদান করে। সার্ভার ক্রমবর্ধমান ডাউনলোডগুলি বাস্তবায়ন করতে পূর্ববর্তী syncToken ব্যবহার করতে পারে।

ফাইল ফরম্যাট ডাউনলোড করুন

ডাউনলোড করা ফাইলটি নিম্নলিখিত কাঠামো সহ একটি JSON ফাইল। ডাউনলোড করা ডেটার সংস্করণ সনাক্ত করতে JSON ফাইলটিতে একটি সিঙ্কটোকেন থাকতে পারে বলে আশা করা হচ্ছে৷ SyncToken অবশ্যই একটি UTC টাইমস্ট্যাম্প হতে হবে যা এক ঘন্টার সীমারেখায় আটকানো হবে এবং পূর্ববর্তী ডাউনলোডের সিঙ্কটোকেনকে অতিক্রম করতে হবে৷ যদি সিঙ্কটোকেন উভয় প্রয়োজনীয়তা পূরণ না করে, ডাউনলোড করা সামগ্রী প্রক্রিয়াকরণ ছাড়াই বাতিল করা হয়।

বিষয়বস্তু ক্ষেত্র হল (কী, ডেটা, এনকোডিং) টিপলের একটি তালিকা। key একটি UTF-8 স্ট্রিং হবে বলে আশা করা হচ্ছে। encoding ক্ষেত্র হল একটি ঐচ্ছিক পরামিতি যা নির্দিষ্ট করে যে কিভাবে data ক্ষেত্রটি এনকোড করা হয় - এটি "utf8" বা "base64" এ সেট করা যেতে পারে এবং ডিফল্টরূপে "utf8" বলে ধরে নেওয়া হয়। key ক্ষেত্রটিকে একটি String অবজেক্টে রূপান্তরিত করা হয় এবং onDownloadCompleted(). কল করার আগে data ক্ষেত্রটি একটি বাইট অ্যারেতে রূপান্তরিত হয়।

{
  // syncToken must be a UTC timestamp clamped to an hour boundary, and must be
  // greater than the syncToken of the previously completed download.
  "syncToken": <timeStampInSecRoundedToUtcHour>,
  "contents": [
    // List of { key, data } pairs.
    { "key": "key1",
      "data": "data1"
    },
    { "key": "key2",
      "data": "data2",
      "encoding": "base64"
    },
    // ...
  ]
}

সার্ভার-সাইড API

এই বিভাগটি বর্ণনা করে কিভাবে ফেডারেটেড কম্পিউট সার্ভার API-এর সাথে ইন্টারঅ্যাক্ট করতে হয়।

ফেডারেটেড কম্পিউট সার্ভার API

ক্লায়েন্ট সাইডে একটি ফেডারেটেড কম্পিউট কাজের সময় নির্ধারণ করতে, আপনার রিমোট ফেডারেটেড কম্পিউট সার্ভারে তৈরি একটি জনসংখ্যার নাম সহ একটি টাস্ক প্রয়োজন। এই বিভাগে, আমরা ফেডারেটেড কম্পিউট সার্ভারে কীভাবে এমন একটি কাজ তৈরি করতে পারি তা কভার করি।

ফেডারেটেড কম্পিউট ক্লায়েন্ট-সার্ভার টপোলজির চিত্র।

টাস্ক বিল্ডারের জন্য একটি নতুন টাস্ক তৈরি করার সময়, ODP ডেভেলপারদের ফাইলের দুটি সেট প্রদান করা উচিত:

1. tff.learning.models.save_functional_model API কল করার মাধ্যমে একটি সংরক্ষিত tff.learning.models.FunctionalModel মডেল। আপনি আমাদের GitHub সংগ্রহস্থলে একটি নমুনা খুঁজে পেতে পারেন।
2. একটি fcp_server_config.json যার মধ্যে রয়েছে নীতি, ফেডারেটেড লার্নিং সেটআপ এবং ডিফারেনশিয়াল প্রাইভেসি সেটআপ। নিম্নলিখিত একটি fcp_server_config.json এর উদাহরণ:

{
  # Task execution mode.
  mode: TRAINING_AND_EVAL
  # Identifies the set of client devices that participate.
  population_name: "mnist_cnn_task"
  policies {
    # Policy for sampling on-device examples. It is checked every
    # time a device is attempting to start a new training.
    min_separation_policy {
      # The minimum separation required between two successful
      # consective task executions. If a client successfully contributes
      # to a task at index `x`, the earliest they can contribute again
      # is at index `(x + minimum_separation)`. This is required by
      # DP.
      minimum_separation: 1
    }
    data_availability_policy {
      # The minimum number of examples on a device to be considered
      # eligible for training.
      min_example_count: 1
    }
    # Policy for releasing training results to developers adopting ODP.
    model_release_policy {
      # The maximum number of training rounds.
      num_max_training_rounds: 512
    }
  }

  # Federated learning setups. They are applied inside Task Builder.
  federated_learning {
    # Use federated averaging to build federated learning process.
    # Options you can choose:
      # * FED_AVG: Federated Averaging algorithm
      #            (https://arxiv.org/abs/2003.00295)
      # * FED_SGD: Federated SGD algorithm
      #            (https://arxiv.org/abs/1602.05629)
    type: FED_AVG
    learning_process {
      # Optimizer used at client side training. Options you can choose:
      # * ADAM
      # * SGD
      client_optimizer: SGD
      # Learning rate used at client side training.
      client_learning_rate: 0.02
      # Optimizer used at server side training. Options you can choose:
      # * ADAM
      # * SGD
      server_optimizer: SGD
      # Learning rate used at server side training.
      server_learning_rate: 1.0
      runtime_config {
        # Number of participating devices for each round of training.
      report_goal: 2
      }
      metrics {
        name: "sparse_categorical_accuracy"
      }
    }
    evaluation {
      # A checkpoint selector controls how checkpoints are chosen for
      # evaluation. One evaluation task typically runs per training
      # task, and on each round of execution, the eval task
      # randomly picks one checkpoint from the past 24 hours that has
      # been selected for evaluation by these rules.
      # Every_k_round and every_k_hour are definitions of quantization
      # buckets which each checkpoint is placed in for selection.
      checkpoint_selector: "every_1_round"
      # The percentage of a populate that should delicate to this
      # evaluation task.
      evaluation_traffic: 0.2
      # Number of participating devices for each round of evaluation.
      report_goal: 2
    }
  }

  # Differential Privacy setups. They are enforced inside the Task
  # Builder.
  differential_privacy {
    # * fixed_gaussian: DP-SGD with fixed clipping norm described in
    #                   "Learning Differentially Private Recurrent
    #                   Language Models"
    #                   (https://arxiv.org/abs/1710.06963).
    type: FIXED_GAUSSIAN
    #   The value of the clipping norm.
    clip_norm: 0.1
    # Noise multiplier for the Gaussian noise.
    noise_multiplier: 0.1
  }
}

আপনি আমাদের GitHub সংগ্রহস্থলে আরও নমুনা খুঁজে পেতে পারেন।

এই দুটি ইনপুট প্রস্তুত করার পরে, শিল্পকর্ম তৈরি করতে এবং নতুন কাজ তৈরি করতে টাস্ক বিল্ডারকে আহ্বান করুন। আরও বিস্তারিত নির্দেশাবলী আমাদের GitHub সংগ্রহস্থলে উপলব্ধ।