এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

কোটলিন | জাভা

interface EnvironmentClient

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

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

সারাংশ

পাবলিক ফাংশন
`suspend Environment`	`getEnvironment (request: GetEnvironmentRequest )` `Environment` ফিরিয়ে দেয়।
`ListenableFuture < Environment >`	`getEnvironmentAsync (request: GetEnvironmentRequest )` `Environment` ফিরিয়ে দেয়।
`suspend PrepareEnvironmentResponse`	`prepareEnvironment ( request: PrepareEnvironmentRequest , notificationServiceComponentName: ComponentName ? )` ডিভাইসের পরিবেশ প্রস্তুত করে।
`ListenableFuture < PrepareEnvironmentResponse >`	`prepareEnvironmentAsync ( request: PrepareEnvironmentRequest , notificationServiceComponentName: ComponentName ? )` ডিভাইসের পরিবেশ প্রস্তুত করে।

পাবলিক ফাংশন

পরিবেশ পান

suspend fun getEnvironment(request: GetEnvironmentRequest): Environment

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

নিক্ষেপ করে
`com.google.android.managementapi.common.exceptions.InvalidArgumentException`	অনুরোধকৃত ভূমিকা বৈধ না হলে.
`com.google.android.managementapi.common.exceptions.InternalException`	অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হলে।
`com.google.android.managementapi.common.exceptions.ApiLevelException`	যদি ডিভাইসের SDK API স্তর নির্দিষ্ট অনুরোধকৃত ভূমিকার জন্য অপর্যাপ্ত হয় (এটি কলের জন্য একটি সাধারণ ন্যূনতম API স্তরের প্রয়োজনীয়তা ছাড়াও হতে পারে)। {@code Role.RoleType.DEVICE_POLICY_CONTROLLER}-এর জন্য API স্তর 23 বা তার উপরে প্রয়োজন৷ অন্য যেকোনো ভূমিকার জন্য API স্তর 28 বা তার বেশি প্রয়োজন।

EnvironmentAsync পান

fun getEnvironmentAsync(request: GetEnvironmentRequest): ListenableFuture<Environment>

রিটার্নস

রিটার্নস
`ListenableFuture < Environment >`	একটি `ListenableFuture` ফলাফল মোড়ানো. এটি হতে পারে: একটি সফল ভবিষ্যত একটি `Environment` মোড়ানো, সাফল্যের ক্ষেত্রে। একটি ব্যর্থ ভবিষ্যত একটি `InvalidArgumentException` মোড়ানো, যদি অনুরোধকৃত ভূমিকা বৈধ না হয়। একটি ব্যর্থ ভবিষ্যৎ একটি `InternalException` মোড়ানো, যদি একটি অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হয়।

ListenableFuture < Environment >

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

একটি সফল ভবিষ্যত একটি Environment মোড়ানো, সাফল্যের ক্ষেত্রে।
একটি ব্যর্থ ভবিষ্যত একটি InvalidArgumentException মোড়ানো, যদি অনুরোধকৃত ভূমিকা বৈধ না হয়।
একটি ব্যর্থ ভবিষ্যৎ একটি InternalException মোড়ানো, যদি একটি অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হয়।

নিক্ষেপ করে

নিক্ষেপ করে
`com.google.android.managementapi.common.exceptions.ApiLevelException`	যদি ডিভাইসের SDK API স্তর নির্দিষ্ট অনুরোধকৃত ভূমিকার জন্য অপর্যাপ্ত হয় (এটি কলের জন্য একটি সাধারণ ন্যূনতম API স্তরের প্রয়োজনীয়তা ছাড়াও হতে পারে)। {@code Role.RoleType.DEVICE_POLICY_CONTROLLER}-এর জন্য API স্তর 23 বা তার উপরে প্রয়োজন৷ অন্য যেকোনো ভূমিকার জন্য API স্তর 28 বা তার বেশি প্রয়োজন।

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

যদি ডিভাইসের SDK API স্তর নির্দিষ্ট অনুরোধকৃত ভূমিকার জন্য অপর্যাপ্ত হয় (এটি কলের জন্য একটি সাধারণ ন্যূনতম API স্তরের প্রয়োজনীয়তা ছাড়াও হতে পারে)। {@code Role.RoleType.DEVICE_POLICY_CONTROLLER}-এর জন্য API স্তর 23 বা তার উপরে প্রয়োজন৷ অন্য যেকোনো ভূমিকার জন্য API স্তর 28 বা তার বেশি প্রয়োজন।

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

suspend fun prepareEnvironment(
    request: PrepareEnvironmentRequest,
    notificationServiceComponentName: ComponentName?
): PrepareEnvironmentResponse

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

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

পরামিতি

পরামিতি
`notificationServiceComponentName: ComponentName ?`	`NotificationReceiverService` প্রসারিত পরিষেবার `ComponentName` ৷ প্রদান করা হলে, এটি কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান হতে হবে এবং ম্যানিফেস্টে রপ্তানি করা হবে। পরিবেশ প্রস্তুতি ইভেন্টগুলির বিজ্ঞপ্তি পেতে, আপনাকে এটি করতে হবে: আপনার অ্যাপে `EnvironmentListener` ইন্টারফেস প্রয়োগ করুন। প্রাপ্ত ইভেন্টগুলি কীভাবে পরিচালনা করবেন তার জন্য একটি বাস্তবায়ন প্রদান করুন। NotificationReceiverService প্রসারিত করুন এবং একটি `EnvironmentListener` উদাহরণ প্রদান করুন। আপনার AndroidManifest.xml-এ বর্ধিত NotificationReceiverService ক্লাস যোগ করুন এবং নিশ্চিত করুন যে এটি রপ্তানি হয়েছে। যেমন: class MyEnvironmentListener : EnvironmentListener { override fun onEnvironmentEvent(event: EnvironmentEvent) { // Handle the environment event. } } class MyNotificationReceiverService : NotificationReceiverService() { override fun getPrepareEnvironmentListener(): EnvironmentListener? { return MyEnvironmentListener() } }

notificationServiceComponentName: ComponentName ?

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

আপনার অ্যাপে EnvironmentListener ইন্টারফেস প্রয়োগ করুন।
প্রাপ্ত ইভেন্টগুলি কীভাবে পরিচালনা করবেন তার জন্য একটি বাস্তবায়ন প্রদান করুন।
NotificationReceiverService প্রসারিত করুন এবং একটি EnvironmentListener উদাহরণ প্রদান করুন।
আপনার 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] কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান নয় বা ম্যানিফেস্টে রপ্তানি করা হয়নি৷ অনুরোধ করা ভূমিকাগুলির মধ্যে রয়েছে {@code Role.RoleType.DEVICE_POLICY_CONTROLLER} এবং {@code com.google.android.managementapi.environment.model.PrepareEnvironmentRequest.admin} প্রদান করা হয় না বা প্রসারিত হয় না {@code android.app.admin.Devicer}} অনুরোধ করা ভূমিকা বৈধ নয়.
`java.lang.SecurityException`	কলকারী এই API কল করার জন্য অনুমোদিত না হলে.
`com.google.android.managementapi.environment.GooglePlayServicesAppNotUpdatedException`	যদি Google Play পরিষেবাগুলি আপ-টু-ডেট না হয়।
`com.google.android.managementapi.environment.AndroidDevicePolicyInstallOrUpdateUnrecoverableException`	যদি Android ডিভাইস নীতি ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটিটি পুনরুদ্ধার করা যায় না।
`com.google.android.managementapi.environment.AndroidDevicePolicyInstallOrUpdateRecoverableException`	যদি অ্যান্ড্রয়েড ডিভাইস পলিসি অ্যাপ ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটিটি পুনরুদ্ধারযোগ্য হয় (যেমন ক্ষণস্থায়ী নেটওয়ার্ক সমস্যার কারণে অনুরোধ ব্যর্থ হয়েছে), তাই অনুরোধটি পুনরায় চেষ্টা করা যেতে পারে।
`com.google.android.managementapi.environment.AndroidDevicePolicyInstallConsentDeclinedException`	ব্যবহারকারী যদি Android Device Policy অ্যাপ ইনস্টল করতে অস্বীকার করেন।
`com.google.android.managementapi.environment.AndroidDevicePolicyInstallConsentDismissedException`	ব্যবহারকারী যদি ইনস্টলেশন সম্মতি স্ক্রীন খারিজ করে দেয়।
`com.google.android.managementapi.common.exceptions.InternalException`	অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হলে।
`com.google.android.managementapi.environment.PlayStoreUpdateUnrecoverableException`	প্লে স্টোর আপডেট ব্যর্থ হলে।
`com.google.android.managementapi.common.exceptions.ApiLevelException`	যদি ডিভাইসের SDK API স্তর নির্দিষ্ট অনুরোধকৃত ভূমিকার জন্য অপর্যাপ্ত হয় (এটি কলের জন্য একটি সাধারণ ন্যূনতম API স্তরের প্রয়োজনীয়তা ছাড়াও হতে পারে)।{@code Role.RoleType.DEVICE_POLICY_CONTROLLER} এর জন্য API স্তর 23 বা তার বেশি প্রয়োজন৷ অন্য যেকোনো ভূমিকার জন্য API স্তর 28 বা তার বেশি প্রয়োজন।

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

fun prepareEnvironmentAsync(
    request: PrepareEnvironmentRequest,
    notificationServiceComponentName: ComponentName?
): ListenableFuture<PrepareEnvironmentResponse>

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

পরামিতি

পরামিতি
`notificationServiceComponentName: ComponentName ?`	`NotificationReceiverService` প্রসারিত পরিষেবার `ComponentName` ৷ প্রদান করা হলে, এটি কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান হতে হবে এবং ম্যানিফেস্টে রপ্তানি করা হবে। পরিবেশ প্রস্তুতির ইভেন্টগুলির বিজ্ঞপ্তি পেতে, আপনাকে এটি করতে হবে: আপনার অ্যাপে `EnvironmentListener` ইন্টারফেস প্রয়োগ করুন। প্রাপ্ত ইভেন্টগুলি কীভাবে পরিচালনা করবেন তার জন্য একটি বাস্তবায়ন প্রদান করুন। NotificationReceiverService প্রসারিত করুন এবং একটি `EnvironmentListener` উদাহরণ প্রদান করুন। আপনার AndroidManifest.xml-এ বর্ধিত NotificationReceiverService ক্লাস যোগ করুন এবং নিশ্চিত করুন যে এটি রপ্তানি হয়েছে। যেমন: class MyEnvironmentListener : EnvironmentListener { override fun onEnvironmentEvent(event: EnvironmentEvent) { // Handle the environment event. } } class MyNotificationReceiverService : NotificationReceiverService() { override fun getPrepareEnvironmentListener(): EnvironmentListener? { return MyEnvironmentListener() } }

notificationServiceComponentName: ComponentName ?

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

আপনার অ্যাপে EnvironmentListener ইন্টারফেস প্রয়োগ করুন।
প্রাপ্ত ইভেন্টগুলি কীভাবে পরিচালনা করবেন তার জন্য একটি বাস্তবায়ন প্রদান করুন।
NotificationReceiverService প্রসারিত করুন এবং একটি EnvironmentListener উদাহরণ প্রদান করুন।
আপনার 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] কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান নয় বা ম্যানিফেস্টে রপ্তানি করা হয়নি৷ অনুরোধ করা ভূমিকা বৈধ নয়. অনুরোধ করা ভূমিকাগুলির মধ্যে রয়েছে {@code Role.RoleType.DEVICE_POLICY_CONTROLLER} এবং {@code com.google.android.managementapi.environment.model.PrepareEnvironmentRequest.admin} প্রদান করা হয় না বা প্রসারিত হয় না {@code android.app.admin.Devicer}} একটি ব্যর্থ ভবিষ্যৎ একটি `SecurityException` মোড়ানো, যদি কলকারী এই API কল করার জন্য অনুমোদিত না হয়। Google Play Services আপ-টু-ডেট না থাকলে একটি `GooglePlayServicesAppNotUpdatedException` মোড়ানো একটি ব্যর্থ ভবিষ্যৎ। একটি ব্যর্থ ভবিষ্যৎ একটি `AndroidDevicePolicyInstallOrUpdateUnrecoverableException` মোড়ানো যদি Android ডিভাইস নীতি ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটিটি পুনরুদ্ধার করা যায় না। একটি ব্যর্থ ভবিষ্যৎ একটি `AndroidDevicePolicyInstallOrUpdateRecoverableException` যদি Android ডিভাইস নীতি অ্যাপ ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটি পুনরুদ্ধারযোগ্য হয় (যেমন ক্ষণস্থায়ী নেটওয়ার্ক সমস্যার কারণে অনুরোধ ব্যর্থ হয়েছে), তাই অনুরোধটি পুনরায় চেষ্টা করা যেতে পারে। যদি ব্যবহারকারী Android ডিভাইস নীতি অ্যাপ ইনস্টল করতে অস্বীকার করে তাহলে একটি `AndroidDevicePolicyInstallConsentDeclinedException` মোড়ানো একটি ব্যর্থ ভবিষ্যৎ। একটি ব্যর্থ ভবিষ্যৎ একটি `AndroidDevicePolicyInstallConsentDismissedException` মোড়ানো যদি ব্যবহারকারী ইনস্টলেশনের সম্মতি স্ক্রীন খারিজ করে দেয়। একটি ব্যর্থ ভবিষ্যৎ একটি `InternalException` মোড়ানো, যদি একটি অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হয়। প্লে স্টোর আপডেট ব্যর্থ হলে একটি ব্যর্থ ভবিষ্যৎ একটি `PlayStoreUpdateUnrecoverableException` মোড়ানো।

ListenableFuture < PrepareEnvironmentResponse >

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

একটি সফল ভবিষ্যৎ একটি PrepareEnvironmentResponse মোড়ানো যাতে পরিবেশ প্রস্তুতির চূড়ান্ত অবস্থা সম্পর্কে বিশদ বিবরণ রয়েছে।
একটি ব্যর্থ ভবিষ্যৎ একটি InvalidArgumentException মোড়ানো যদি:
- [notificationServiceComponentName] কলিং অ্যাপের অন্তর্গত একটি বৈধ উপাদান নয় বা ম্যানিফেস্টে রপ্তানি করা হয়নি৷
- অনুরোধ করা ভূমিকা বৈধ নয়.
- অনুরোধ করা ভূমিকাগুলির মধ্যে রয়েছে {@code Role.RoleType.DEVICE_POLICY_CONTROLLER} এবং {@code com.google.android.managementapi.environment.model.PrepareEnvironmentRequest.admin} প্রদান করা হয় না বা প্রসারিত হয় না {@code android.app.admin.Devicer}}
একটি ব্যর্থ ভবিষ্যৎ একটি SecurityException মোড়ানো, যদি কলকারী এই API কল করার জন্য অনুমোদিত না হয়।
Google Play Services আপ-টু-ডেট না থাকলে একটি GooglePlayServicesAppNotUpdatedException মোড়ানো একটি ব্যর্থ ভবিষ্যৎ।
একটি ব্যর্থ ভবিষ্যৎ একটি AndroidDevicePolicyInstallOrUpdateUnrecoverableException মোড়ানো যদি Android ডিভাইস নীতি ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটিটি পুনরুদ্ধার করা যায় না।
একটি ব্যর্থ ভবিষ্যৎ একটি AndroidDevicePolicyInstallOrUpdateRecoverableException যদি Android ডিভাইস নীতি অ্যাপ ইনস্টল বা আপডেট করতে ব্যর্থ হয় এবং ত্রুটি পুনরুদ্ধারযোগ্য হয় (যেমন ক্ষণস্থায়ী নেটওয়ার্ক সমস্যার কারণে অনুরোধ ব্যর্থ হয়েছে), তাই অনুরোধটি পুনরায় চেষ্টা করা যেতে পারে।
যদি ব্যবহারকারী Android ডিভাইস নীতি অ্যাপ ইনস্টল করতে অস্বীকার করে তাহলে একটি AndroidDevicePolicyInstallConsentDeclinedException মোড়ানো একটি ব্যর্থ ভবিষ্যৎ।
একটি ব্যর্থ ভবিষ্যৎ একটি AndroidDevicePolicyInstallConsentDismissedException মোড়ানো যদি ব্যবহারকারী ইনস্টলেশনের সম্মতি স্ক্রীন খারিজ করে দেয়।
একটি ব্যর্থ ভবিষ্যৎ একটি InternalException মোড়ানো, যদি একটি অভ্যন্তরীণ ত্রুটির কারণে কল ব্যর্থ হয়।
প্লে স্টোর আপডেট ব্যর্থ হলে একটি ব্যর্থ ভবিষ্যৎ একটি PlayStoreUpdateUnrecoverableException মোড়ানো।

নিক্ষেপ করে

নিক্ষেপ করে
`com.google.android.managementapi.common.exceptions.ApiLevelException`	ডিভাইসের SDK API স্তর নির্দিষ্ট অনুরোধকৃত ভূমিকার জন্য অপর্যাপ্ত হলে। {@code Role.RoleType.DEVICE_POLICY_CONTROLLER}-এর জন্য API স্তর 23 বা তার উপরে প্রয়োজন৷ অন্য যেকোনো ভূমিকার জন্য API স্তর 28 বা তার বেশি প্রয়োজন।

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

ডিভাইসের SDK API স্তর নির্দিষ্ট অনুরোধকৃত ভূমিকার জন্য অপর্যাপ্ত হলে। {@code Role.RoleType.DEVICE_POLICY_CONTROLLER}-এর জন্য API স্তর 23 বা তার উপরে প্রয়োজন৷ অন্য যেকোনো ভূমিকার জন্য API স্তর 28 বা তার বেশি প্রয়োজন।