এনভায়রনমেন্ট ক্লায়েন্ট 

interface EnvironmentClient

পরিবেশ সম্পর্কিত এপিএস অ্যাক্সেস করার জন্য ক্লায়েন্ট।

একটি উদাহরণ তৈরি করতে EnvironmentClientFactory ব্যবহার করুন।

সারাংশ

পাবলিক ফাংশন

suspend Environment

Environment ফিরিয়ে দেয়।

ListenableFuture < Environment >

Environment ফিরিয়ে দেয়।

suspend PrepareEnvironmentResponse
@ RequiresApi (value = 28)
prepareEnvironment (
request: PrepareEnvironmentRequest ,
notificationServiceComponentName: ComponentName ?
)

ডিভাইসের পরিবেশ প্রস্তুত করে।

ListenableFuture < PrepareEnvironmentResponse >
@ RequiresApi (value = 28)
prepareEnvironmentAsync (
request: PrepareEnvironmentRequest ,
notificationServiceComponentName: ComponentName ?
)

ডিভাইসের পরিবেশ প্রস্তুত করে।

পাবলিক ফাংশন

পরিবেশ পান 

@RequiresApi(value = 28)
suspend fun getEnvironment(request: GetEnvironmentRequest): Environment

Environment ফিরিয়ে দেয়। এটি কলকারীকে পরিবেশ প্রস্তুত কিনা তা জানতে সাহায্য করে।

নিক্ষেপ করে
java.lang.SecurityException

কলকারী এই API কল করার জন্য অনুমোদিত না হলে.

com.google.android.managementapi.common.exceptions.ApiLevelException

ডিভাইস API স্তর 28 এর কম হলে।

com.google.android.managementapi.common.exceptions.InvalidArgumentException

অনুরোধকৃত ভূমিকা বৈধ না হলে.

com.google.android.managementapi.common.exceptions.InternalException

অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হলে।

EnvironmentAsync পান 

@RequiresApi(value = 28)
fun getEnvironmentAsync(request: GetEnvironmentRequest): ListenableFuture<Environment>

Environment ফিরিয়ে দেয়। এটি কলকারীকে পরিবেশ প্রস্তুত কিনা তা জানতে সাহায্য করে।

রিটার্নস
ListenableFuture < Environment >

একটি ListenableFuture ফলাফল মোড়ানো. এটি হতে পারে:

  • একটি সফল ভবিষ্যৎ একটি Environment মোড়ানো, সাফল্যের ক্ষেত্রে।

  • একটি ব্যর্থ ভবিষ্যৎ একটি SecurityException মোড়ানো, যদি কলকারী এই API কল করার জন্য অনুমোদিত না হয়।

  • একটি ব্যর্থ ভবিষ্যৎ একটি ApiLevelException মোড়ানো, যদি ডিভাইসের API স্তর 28-এর কম হয়।

  • একটি ব্যর্থ ভবিষ্যত একটি InvalidArgumentException মোড়ানো, যদি অনুরোধকৃত ভূমিকা বৈধ না হয়।

  • একটি ব্যর্থ ভবিষ্যৎ একটি InternalException মোড়ানো, যদি একটি অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হয়।

প্রস্তুত পরিবেশ 

@RequiresApi(value = 28)
suspend fun prepareEnvironment(
    request: PrepareEnvironmentRequest,
    notificationServiceComponentName: ComponentName?
): PrepareEnvironmentResponse

ডিভাইসের পরিবেশ প্রস্তুত করে।

প্রয়োজনীয় Android ডিভাইস নীতি অ্যাপ্লিকেশন ইনস্টল করার জন্য ব্যবহারকারীকে অনুরোধ করে। ব্যবহারকারী প্রম্পট গ্রহণ করলে ইনস্টলেশনের সাথে এগিয়ে যান। সফল ইনস্টলেশনের পরে, এটি Android ডিভাইস নীতি অ্যাপটি প্রস্তুত কিনা তা নিশ্চিত করতে ক্রিয়াকলাপ সম্পাদন করে৷

পরামিতি
notificationServiceComponentName: ComponentName ?

NotificationReceiverService প্রসারিত পরিষেবার ComponentName ৷ প্রদান করা হলে, এটি কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান হতে হবে এবং ম্যানিফেস্টে রপ্তানি করা হবে। পরিবেশ প্রস্তুতি ইভেন্টগুলির বিজ্ঞপ্তি পেতে, আপনাকে এটি করতে হবে:

  1. আপনার অ্যাপে EnvironmentListener ইন্টারফেস প্রয়োগ করুন।

  2. প্রাপ্ত ইভেন্টগুলি কীভাবে পরিচালনা করবেন তার জন্য একটি বাস্তবায়ন প্রদান করুন।

  3. NotificationReceiverService প্রসারিত করুন এবং একটি EnvironmentListener উদাহরণ প্রদান করুন।

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

যেমন:

class MyEnvironmentListener : EnvironmentListener {
  override fun onEnvironmentEvent(event: EnvironmentEvent) {
    // Handle the environment event.
  }
}

class MyNotificationReceiverService : NotificationReceiverService() {
  override fun getPrepareEnvironmentListener(): EnvironmentListener? {
    return MyEnvironmentListener()
  }
}
রিটার্নস
PrepareEnvironmentResponse

পরিবেশ প্রস্তুতির চূড়ান্ত অবস্থা সম্বন্ধে বিশদ বিবরণ সহ PrepareEnvironmentResponse ।

নিক্ষেপ করে
com.google.android.managementapi.common.exceptions.InvalidArgumentException

যদি:

  • [notificationServiceComponentName] কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান নয় বা ম্যানিফেস্টে রপ্তানি করা হয়নি৷
  • অনুরোধ করা ভূমিকা বৈধ নয়.
com.google.android.managementapi.common.exceptions.ApiLevelException

ডিভাইস API স্তর 28 এর কম হলে।

java.lang.SecurityException

কলকারী এই API কল করার জন্য অনুমোদিত না হলে.

com.google.android.managementapi.environment.exception.GooglePlayServicesAppNotUpdatedException যদি Google Play পরিষেবাগুলি আপ-টু-ডেট না হয়।

com.google.android.managementapi.environment.exception.AndroidDevicePolicyInstallOrUpdateUnrecoverableException যদি Android ডিভাইস নীতি ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটিটি পুনরুদ্ধার করা যায় না।

com.google.android.managementapi.environment.exception.AndroidDevicePolicyInstallOrUpdateRecoverableException যদি Android ডিভাইস নীতি অ্যাপ ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটিটি পুনরুদ্ধারযোগ্য হয় (যেমন ক্ষণস্থায়ী নেটওয়ার্ক সমস্যার কারণে অনুরোধ ব্যর্থ হয়েছে), তাই অনুরোধটি পুনরায় চেষ্টা করা যেতে পারে।

com.google.android.managementapi.environment.exception.AndroidDevicePolicyInstallConsentDeclinedException যদি ব্যবহারকারী Android ডিভাইস নীতি অ্যাপ ইনস্টল করতে অস্বীকার করে।

com.google.android.managementapi.environment.exception.AndroidDevicePolicyInstallConsentDismissedException যদি ব্যবহারকারী ইনস্টলেশনের সম্মতি স্ক্রীন খারিজ করে দেয়।

com.google.android.managementapi.common.exceptions.InternalException

অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হলে।

প্রস্তুত পরিবেশ-অ্যাসিঙ্ক 

@RequiresApi(value = 28)
fun prepareEnvironmentAsync(
    request: PrepareEnvironmentRequest,
    notificationServiceComponentName: ComponentName?
): ListenableFuture<PrepareEnvironmentResponse>

ডিভাইসের পরিবেশ প্রস্তুত করে।

প্রয়োজনীয় Android ডিভাইস নীতি অ্যাপ্লিকেশন ইনস্টল করার জন্য ব্যবহারকারীকে অনুরোধ করে। ব্যবহারকারী প্রম্পট গ্রহণ করলে ইনস্টলেশনের সাথে এগিয়ে যান। সফল ইনস্টলেশনের পরে, এটি Android ডিভাইস নীতি অ্যাপটি প্রস্তুত কিনা তা নিশ্চিত করতে ক্রিয়াকলাপ সম্পাদন করে৷

পরামিতি
notificationServiceComponentName: ComponentName ?

NotificationReceiverService প্রসারিত পরিষেবার ComponentName ৷ প্রদান করা হলে, এটি কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান হতে হবে এবং ম্যানিফেস্টে রপ্তানি করা হবে। পরিবেশ প্রস্তুতির ইভেন্টগুলির বিজ্ঞপ্তি পেতে, আপনাকে এটি করতে হবে:

  1. আপনার অ্যাপে EnvironmentListener ইন্টারফেস প্রয়োগ করুন।

  2. প্রাপ্ত ইভেন্টগুলি কীভাবে পরিচালনা করবেন তার জন্য একটি বাস্তবায়ন প্রদান করুন।

  3. NotificationReceiverService প্রসারিত করুন এবং একটি EnvironmentListener উদাহরণ প্রদান করুন।

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

যেমন:

class MyEnvironmentListener : EnvironmentListener {
  override fun onEnvironmentEvent(event: EnvironmentEvent) {
    // Handle the environment event.
  }
}

class MyNotificationReceiverService : NotificationReceiverService() {
  override fun getPrepareEnvironmentListener(): EnvironmentListener? {
    return MyEnvironmentListener()
  }
}
রিটার্নস
ListenableFuture < PrepareEnvironmentResponse >

একটি ListenableFuture ফলাফল মোড়ানো. এই হতে পারে

  • একটি সফল ভবিষ্যৎ একটি PrepareEnvironmentResponse মোড়ানো যাতে পরিবেশ প্রস্তুতির চূড়ান্ত অবস্থা সম্পর্কে বিশদ বিবরণ রয়েছে।

  • একটি ব্যর্থ ভবিষ্যৎ একটি InvalidArgumentException মোড়ানো যদি:

    • [notificationServiceComponentName] কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান নয় বা ম্যানিফেস্টে রপ্তানি করা হয়নি৷
    • অনুরোধ করা ভূমিকা বৈধ নয়.

  • ডিভাইস API স্তর 28-এর কম হলে একটি ApiLevelException মোড়ানো একটি ব্যর্থ ভবিষ্যৎ।

  • একটি ব্যর্থ ভবিষ্যৎ একটি SecurityException মোড়ানো, যদি কলকারী এই API কল করার জন্য অনুমোদিত না হয়।

  • Google Play Services আপ-টু-ডেট না থাকলে একটি GooglePlayServicesAppNotUpdatedException মোড়ানো একটি ব্যর্থ ভবিষ্যৎ।

  • একটি ব্যর্থ ভবিষ্যৎ একটি AndroidDevicePolicyInstallOrUpdateUnrecoverableException মোড়ানো যদি Android ডিভাইস নীতি ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটিটি পুনরুদ্ধার করা যায় না।

  • একটি ব্যর্থ ভবিষ্যৎ একটি AndroidDevicePolicyInstallOrUpdateRecoverableException যদি Android ডিভাইস নীতি অ্যাপ ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটি পুনরুদ্ধারযোগ্য হয় (যেমন ক্ষণস্থায়ী নেটওয়ার্ক সমস্যার কারণে অনুরোধ ব্যর্থ হয়েছে), তাই অনুরোধটি পুনরায় চেষ্টা করা যেতে পারে।

  • যদি ব্যবহারকারী Android ডিভাইস নীতি অ্যাপ ইনস্টল করতে অস্বীকার করে তাহলে একটি AndroidDevicePolicyInstallConsentDeclinedException মোড়ানো একটি ব্যর্থ ভবিষ্যৎ।

  • একটি ব্যর্থ ভবিষ্যৎ একটি AndroidDevicePolicyInstallConsentDismissedException মোড়ানো যদি ব্যবহারকারী ইনস্টলেশনের সম্মতি স্ক্রীন খারিজ করে দেয়।

  • একটি ব্যর্থ ভবিষ্যৎ একটি InternalException মোড়ানো, যদি একটি অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হয়।