অ্যাকাউন্ট সেটআপক্লায়েন্ট

কোটলিন | জাভা

public interface AccountSetupClient

---

ডিভাইসে একটি পরিচালিত অ্যাকাউন্টের সেটআপ পরিচালনার জন্য ক্লায়েন্ট।

লাইফসাইকেল ইন্টিগ্রেশনের প্রয়োজনীয়তা: launchAuthenticationActivity মতো অপারেশনের জন্য প্রয়োজনীয় ফলাফল কলব্যাকগুলি সঠিকভাবে পরিচালনা করার জন্য, এই ক্লায়েন্টটি AndroidX Activity Result API-এর উপর নির্ভর করে। কলারকে এই ক্লায়েন্টকে Android কম্পোনেন্ট লাইফসাইকেল (অ্যাক্টিভিটি বা ফ্র্যাগমেন্ট) এর সাথে সংহত করতে হবে :

1. getLifecycleObserver ব্যবহার করে পর্যবেক্ষক পুনরুদ্ধার করা হচ্ছে।

2. এই পর্যবেক্ষককে হোস্ট অ্যাক্টিভিটি বা ফ্র্যাগমেন্টের Lifecycle সাথে নিবন্ধন করা, সাধারণত onCreate (যেমন, lifecycle.addObserver(client.lifecycleObserver) )।

স্ট্যাটাস আপডেট: অ্যাসিঙ্ক্রোনাস অ্যাকাউন্ট সেটআপ স্ট্যাটাস পরিবর্তনের বিজ্ঞপ্তি পেতে, কলিং অ্যাপটির যা করতে হবে:

1. AccountSetupListener ইন্টারফেসটি বাস্তবায়ন করুন।

2. প্রাপ্ত স্ট্যাটাস আপডেট পরিচালনার জন্য একটি বাস্তবায়ন প্রদান করুন।

3. NotificationReceiverService প্রসারিত করুন এবং একটি AccountSetupListener ইনস্ট্যান্স প্রদান করুন।

4. আপনার AndroidManifest.xml-এ বর্ধিত NotificationReceiverService ক্লাসটি যোগ করুন এবং নিশ্চিত করুন যে এটি রপ্তানি করা হয়েছে।

এই ক্লায়েন্টের একটি ইনস্ট্যান্স তৈরি করতে AccountSetupClientFactory ব্যবহার করুন।

সারাংশ

পাবলিক পদ্ধতি
abstract @ NonNull AccountSetupAttempt	cancelAccountSetupAttempt ( @ NonNull CancelAccountSetupAttemptRequest cancelAccountSetupAttemptRequest ) নির্দিষ্ট অ্যাকাউন্ট সেটআপ প্রচেষ্টা বাতিল করে।
abstract @ NonNull ListenableFuture <@ NonNull AccountSetupAttempt >	cancelAccountSetupAttemptFuture ( @ NonNull CancelAccountSetupAttemptRequest cancelAccountSetupAttemptRequest ) নির্দিষ্ট অ্যাকাউন্ট সেটআপ প্রচেষ্টা বাতিল করে।
abstract @ NonNull LifecycleObserver	getLifecycleObserver () এই ক্লায়েন্টের জন্য লাইফসাইকেল-নির্ভর সেটআপ পরিচালনা করে এমন LifecycleObserver ।
abstract @ NonNull AccountSetupAttempt	launchAuthenticationActivity ( @ NonNull LaunchAuthenticationActivityRequest launchAuthenticationActivityRequest ) ব্যবহারকারীকে প্রমাণীকরণের জন্য মিনিট মেইড অ্যাক্টিভিটি চালু করে, অথবা যদি অ্যাকাউন্টটি ইতিমধ্যেই ডিভাইসে উপস্থিত থাকে তবে অ্যাকাউন্ট পিকারকে।
abstract @ NonNull ListenableFuture <@ NonNull AccountSetupAttempt >	launchAuthenticationActivityFuture ( @ NonNull LaunchAuthenticationActivityRequest launchAuthenticationActivityRequest ) ব্যবহারকারীকে প্রমাণীকরণের জন্য মিনিট মেইড অ্যাক্টিভিটি চালু করে, অথবা যদি অ্যাকাউন্টটি ইতিমধ্যেই ডিভাইসে উপস্থিত থাকে তবে অ্যাকাউন্ট পিকারকে।
abstract @ NonNull List <@ NonNull AccountSetupAttempt >	listAccountSetupAttempts () সমস্ত অ্যাকাউন্ট সেটআপ প্রচেষ্টা তালিকাভুক্ত করে।
abstract @ NonNull ListenableFuture <@ NonNull List <@ NonNull AccountSetupAttempt >>	listAccountSetupAttemptsFuture () সমস্ত অ্যাকাউন্ট সেটআপ প্রচেষ্টা তালিকাভুক্ত করে।
abstract @ NonNull AccountSetupAttempt	startAccountSetup ( @ NonNull StartAccountSetupRequest startAccountSetupRequest ) অ্যাকাউন্ট সেটআপ শুরু করে।
abstract @ NonNull ListenableFuture <@ NonNull AccountSetupAttempt >	startAccountSetupFuture ( @ NonNull StartAccountSetupRequest startAccountSetupRequest ) অ্যাকাউন্ট সেটআপ শুরু করে।

পাবলিক পদ্ধতি

অ্যাকাউন্ট সেটআপের প্রচেষ্টা বাতিল করুন

abstract @NonNull AccountSetupAttempt cancelAccountSetupAttempt(
    @NonNull CancelAccountSetupAttemptRequest cancelAccountSetupAttemptRequest
)

নির্দিষ্ট অ্যাকাউন্ট সেটআপ প্রচেষ্টা বাতিল করে।

পরামিতি
@ NonNull CancelAccountSetupAttemptRequest cancelAccountSetupAttemptRequest	অ্যাকাউন্ট সেটআপ প্রচেষ্টা বাতিল করার অনুরোধ।

রিটার্নস
@ NonNull AccountSetupAttempt	আপডেট করা অ্যাকাউন্ট সেটআপের প্রচেষ্টা।

বাতিল করুনঅ্যাকাউন্ট সেটআপভবিষ্যতের প্রচেষ্টা

abstract @NonNull ListenableFuture<@NonNull AccountSetupAttempt> cancelAccountSetupAttemptFuture(
    @NonNull CancelAccountSetupAttemptRequest cancelAccountSetupAttemptRequest
)

নির্দিষ্ট অ্যাকাউন্ট সেটআপ প্রচেষ্টা বাতিল করে।

পরামিতি
@ NonNull CancelAccountSetupAttemptRequest cancelAccountSetupAttemptRequest	অ্যাকাউন্ট সেটআপ প্রচেষ্টা বাতিল করার অনুরোধ।

রিটার্নস
@ NonNull ListenableFuture <@ NonNull AccountSetupAttempt >	একটি ListenableFuture ফলাফলটি মোড়ানো। এটি হতে পারে আপডেট করা অ্যাকাউন্ট সেটআপ প্রচেষ্টা সফলভাবে সম্পন্ন করার ভবিষ্যৎ। যদি অ্যাকাউন্ট সেটআপের প্রচেষ্টাটি খুঁজে না পাওয়া যায় অথবা ইতিমধ্যেই চূড়ান্ত অবস্থায় থাকে (ত্রুটি বা সফলতা) তাহলে একটি ব্যর্থ ভবিষ্যৎ।

getLifecycleObserver সম্পর্কে

abstract @NonNull LifecycleObserver getLifecycleObserver()

এই ক্লায়েন্টের জন্য লাইফসাইকেল-নির্ভর সেটআপ পরিচালনা করে এমন LifecycleObserver ।

এই পর্যবেক্ষককে অবশ্যই সেই অ্যাক্টিভিটি বা ফ্র্যাগমেন্টের Lifecycle নিবন্ধিত হতে হবে যা এই ক্লায়েন্ট ইনস্ট্যান্সটি হোস্ট করছে (যেমন, lifecycle.addObserver(...) যা সাধারণত হোস্টের onCreate এ ডাকা হয়)।

এই পর্যবেক্ষক নিবন্ধন করলে ক্লায়েন্ট অভ্যন্তরীণ উপাদানগুলি সঠিকভাবে শুরু করতে পারে, বিশেষ করে launchAuthenticationActivity এর ফলাফল প্রক্রিয়া করার জন্য প্রয়োজনীয় androidx.activity.result.ActivityResultLauncher । এই পর্যবেক্ষক নিবন্ধন করতে ব্যর্থ হলে প্রমাণীকরণ কার্যকলাপ চালু করার চেষ্টা করার সময় ত্রুটি দেখা দেবে।

লঞ্চপ্রমাণীকরণ কার্যকলাপ

abstract @NonNull AccountSetupAttempt launchAuthenticationActivity(
    @NonNull LaunchAuthenticationActivityRequest launchAuthenticationActivityRequest
)

ব্যবহারকারীকে প্রমাণীকরণের জন্য মিনিট মেইড অ্যাক্টিভিটি চালু করে, অথবা যদি অ্যাকাউন্টটি ইতিমধ্যেই ডিভাইসে উপস্থিত থাকে তবে অ্যাকাউন্ট পিকারকে।

পরামিতি
@ NonNull LaunchAuthenticationActivityRequest launchAuthenticationActivityRequest	প্রমাণীকরণ কার্যকলাপ চালু করার অনুরোধ। অনুরোধটিতে AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION অবস্থায় একটি অ্যাকাউন্ট সেটআপ প্রচেষ্টা থাকা আবশ্যক।

থ্রো
java.lang.SecurityException	যদি কলকারী ডিভাইসের মালিক বা প্রোফাইলের মালিক না হন।
com.google.android.managementapi.accountsetup.AccountSetupInvalidStateException	যদি অ্যাকাউন্ট সেটআপের প্রচেষ্টা AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION অবস্থায় না থাকে।

লঞ্চপ্রমাণীকরণঅ্যাক্টিভিটিফিউচার

abstract @NonNull ListenableFuture<@NonNull AccountSetupAttempt> launchAuthenticationActivityFuture(
    @NonNull LaunchAuthenticationActivityRequest launchAuthenticationActivityRequest
)

ব্যবহারকারীকে প্রমাণীকরণের জন্য মিনিট মেইড অ্যাক্টিভিটি চালু করে, অথবা যদি অ্যাকাউন্টটি ইতিমধ্যেই ডিভাইসে উপস্থিত থাকে তবে অ্যাকাউন্ট পিকারকে।

পরামিতি
@ NonNull LaunchAuthenticationActivityRequest launchAuthenticationActivityRequest	প্রমাণীকরণ কার্যকলাপ চালু করার অনুরোধ। অনুরোধটিতে AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION অবস্থায় একটি অ্যাকাউন্ট সেটআপ প্রচেষ্টা থাকা আবশ্যক।

রিটার্নস

@ NonNull ListenableFuture <@ NonNull AccountSetupAttempt >

একটি ListenableFuture ফলাফলটি মোড়ানো। এটি হতে পারে সফল হলে, ভবিষ্যতে IN_PROGRESS অবস্থায় একটি অ্যাকাউন্ট সেটআপ প্রচেষ্টা সফলভাবে সম্পন্ন করা হবে। যদি কলার ডিভাইসের মালিক বা প্রোফাইলের মালিক না হন, তাহলে ভবিষ্যতে SecurityException মোড়ানো ব্যর্থ হবে। যদি অ্যাকাউন্ট সেটআপের প্রচেষ্টা AUTHENTICATION_ACTIVITY_LAUNCH_REQUIRED_INFORMATION অবস্থায় না থাকে, তাহলে ভবিষ্যতে একটি AccountSetupInvalidStateException র‍্যাপ করা ব্যর্থ হবে।

তালিকা অ্যাকাউন্ট সেটআপ প্রচেষ্টা

abstract @NonNull List<@NonNull AccountSetupAttempt> listAccountSetupAttempts()

সমস্ত অ্যাকাউন্ট সেটআপ প্রচেষ্টা তালিকাভুক্ত করে। শুধুমাত্র শেষ ২০টি অ্যাকাউন্ট সেটআপ প্রচেষ্টা ফেরত পাঠানো হয়।

রিটার্নস
@ NonNull List <@ NonNull AccountSetupAttempt >	সমস্ত অ্যাকাউন্ট সেটআপ প্রচেষ্টার একটি তালিকা।

listAccountSetupAttemptsFuture

abstract @NonNull ListenableFuture<@NonNull List<@NonNull AccountSetupAttempt>> listAccountSetupAttemptsFuture()

সমস্ত অ্যাকাউন্ট সেটআপ প্রচেষ্টা তালিকাভুক্ত করে। শুধুমাত্র শেষ ২০টি অ্যাকাউন্ট সেটআপ প্রচেষ্টা ফেরত পাঠানো হয়।

রিটার্নস
@ NonNull ListenableFuture <@ NonNull List <@ NonNull AccountSetupAttempt >>	ফলাফলটি মোড়ানো একটি ListenableFuture ।

স্টার্ট অ্যাকাউন্ট সেটআপ

abstract @NonNull AccountSetupAttempt startAccountSetup(
    @NonNull StartAccountSetupRequest startAccountSetupRequest
)

অ্যাকাউন্ট সেটআপ শুরু করে।

দ্রষ্টব্য: এই পদ্ধতিটি android.app.admin.DevicePolicyManager.DELEGATION_APP_RESTRICTIONS স্কোপটিকে Android Device Policy অ্যাপে অর্পণ করে, যা এটিকে কলিং অ্যাডমিনের পক্ষ থেকে অ্যাপ সীমাবদ্ধতা পরিচালনা করার অনুমতি দেয়। অ্যাকাউন্ট সেটআপ সম্পন্ন হওয়ার পরে, Android Device Policy-তে এই অর্পণের সুযোগটি সরিয়ে ফেলা হবে।

পরামিতি
@ NonNull StartAccountSetupRequest startAccountSetupRequest	অ্যাকাউন্ট সেটআপ শুরু করার অনুরোধ।

রিটার্নস
@ NonNull AccountSetupAttempt	অ্যাকাউন্ট সেটআপের প্রচেষ্টা।

থ্রো
com.google.android.managementapi.environment.exception.EnvironmentNotReadyException	যদি পরিবেশ প্রস্তুত না থাকে।
com.google.android.managementapi.accountsetup.AccountSetupUnknownException	অ্যাকাউন্ট সেটআপের সময় যদি কোন অজানা ত্রুটি দেখা দেয়।
com.google.android.managementapi.accountsetup.AccountSetupInvalidEnrollmentTokenException	যদি তালিকাভুক্তির টোকেন খালি থাকে অথবা অনুরোধে সেট করা না থাকে।
com.google.android.managementapi.accountsetup.AccountSetupInvalidAdminComponentException	যদি অ্যাডমিন DeviceAdminReceiver কম্পোনেন্টটি ডিভাইসে সক্রিয় অ্যাডমিন না হয়।
com.google.android.managementapi.accountsetup.AccountSetupInvalidNotificationReceiverComponentException	যদি ডিভাইসে নোটিফিকেশন রিসিভার কম্পোনেন্ট উপস্থিত না থাকে।

স্টার্টঅ্যাকাউন্টসেটআপফিউচার

abstract @NonNull ListenableFuture<@NonNull AccountSetupAttempt> startAccountSetupFuture(
    @NonNull StartAccountSetupRequest startAccountSetupRequest
)

অ্যাকাউন্ট সেটআপ শুরু করে।

দ্রষ্টব্য: এই পদ্ধতিটি android.app.admin.DevicePolicyManager.DELEGATION_APP_RESTRICTIONS স্কোপটিকে Android Device Policy অ্যাপে অর্পণ করে, যা এটিকে কলিং অ্যাডমিনের পক্ষ থেকে অ্যাপ সীমাবদ্ধতা পরিচালনা করার অনুমতি দেয়। অ্যাকাউন্ট সেটআপ সম্পন্ন হওয়ার পরে, Android Device Policy-তে এই অর্পণের সুযোগটি সরিয়ে ফেলা হবে।

পরামিতি
@ NonNull StartAccountSetupRequest startAccountSetupRequest	অ্যাকাউন্ট সেটআপ শুরু করার অনুরোধ।

রিটার্নস

@ NonNull ListenableFuture <@ NonNull AccountSetupAttempt >

একটি ListenableFuture ফলাফলটি মোড়ানো। এটি হতে পারে অ্যাকাউন্ট সেটআপের প্রচেষ্টা সফলভাবে সম্পন্ন করার একটি ভবিষ্যৎ। পরিবেশ প্রস্তুত না থাকলে ভবিষ্যতে একটি EnvironmentNotReadyException মোড়ানো ব্যর্থ হবে। অ্যাকাউন্ট সেটআপের সময় যদি কোনও অজানা ত্রুটি দেখা দেয়, তাহলে ভবিষ্যতে com.google.android.managementapi.accountsetup.AccountSetupUnknownException মোড়ানো ব্যর্থ হবে। যদি তালিকাভুক্তির টোকেন খালি থাকে অথবা অনুরোধে সেট না থাকে, তাহলে ভবিষ্যতে com.google.android.managementapi.accountsetup.AccountSetupInvalidEnrollmentTokenException র‍্যাপ করা ব্যর্থ হবে। যদি অ্যাডমিন DeviceAdminReceiver কম্পোনেন্টটি ডিভাইসে সক্রিয় অ্যাডমিন না হয়, তাহলে ভবিষ্যতে com.google.android.managementapi.accountsetup.AccountSetupInvalidAdminComponentException র‍্যাপ করা ব্যর্থ হবে। যদি ডিভাইসে নোটিফিকেশন রিসিভার কম্পোনেন্ট উপস্থিত না থাকে, তাহলে ভবিষ্যতে com.google.android.managementapi.accountsetup.AccountSetupInvalidNotificationReceiverComponentException র‍্যাপ করা ব্যর্থ হবে।