کلاس GNSMessageManagerParams
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پارامترهای اضافی برای مدیر پیام
NSObject را به ارث می برد.
| - (BOOL) showBluetoothPowerAlert |
|
read write nonatomic assign |
وقتی بلوتوث خاموش است، هشدار سیستم را نشان دهید. پیش فرض بله است.
| - (GNSErrorStateHandler) microphonePermissionErrorHandler |
|
read write nonatomic copy |
هنگامی که وضعیت خطا تغییر می کند، کنترل کننده های خطای زیر (در رشته اصلی) فراخوانی می شوند.
مقدار YES به معنای خطا است. اجازه میکروفون رد شده است.
| - (GNSErrorStateHandler) bluetoothPermissionErrorHandler |
|
read write nonatomic copy |
| - (GNSErrorStateHandler) bluetoothPowerErrorHandler |
|
read write nonatomic copy |
| - (BOOL) useBestAudioSessionCategory |
|
read write nonatomic assign |
این پارامتر فقط در صورتی مرتبط است که برنامه شما از رسانه صوتی برای کشف استفاده کند.
وقتی روی YES تنظیم شود، Nearby دسته و گزینه‌های AVAudioSession را به ترتیب روی مقادیری تنظیم می‌کند که برای Nearby بهترین عملکرد را دارند: AVAudioSessionCategoryPlayAndRecord و AVAudioSessionCategoryOptionDefaultToSpeaker. اگر آن را روی NO تنظیم کنید، دسته و گزینه‌های فعلی حفظ می‌شوند و توسط Nearby استفاده می‌شوند. این ممکن است منجر به ناتوانی Nearby در پخش یا ضبط صدا شود. به عنوان مثال، اگر برنامه شما از AVAudioSessionCategoryAmbient استفاده می کند، Nearby ممکن است نتواند به صدای دستگاه های اطراف گوش دهد. اگر برنامه شما از AVAudioSessionCategoryRecord استفاده می‌کند، Nearby نمی‌تواند صدا را به دستگاه‌های اطراف پخش کند. پیش فرض بله است.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003eGNSMessageManagerParams\u003c/code\u003e provides additional parameters for managing Nearby Messages.\u003c/p\u003e\n"],["\u003cp\u003eIt includes properties to control system alerts for Bluetooth, handle errors related to microphone/Bluetooth permissions and power, and optimize audio sessions for discovery.\u003c/p\u003e\n"],["\u003cp\u003eBy default, the system alert for Bluetooth power is shown and Nearby attempts to use the best audio session configuration for discovery.\u003c/p\u003e\n"],["\u003cp\u003eError handlers can be set to respond to microphone and Bluetooth permission or power issues.\u003c/p\u003e\n"]]],[],null,["# GNSMessageManagerParams Class\n\n[Properties](#properties) \nGNSMessageManagerParams Class Reference \n\nOverview\n--------\n\nAdditional parameters for the message manager.\n\nInherits NSObject.\n\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| Property Summary ---------------- ||\n| BOOL | [showBluetoothPowerAlert](/nearby/messages/ios/reference/interface_g_n_s_message_manager_params#aa1372276d05adf851d6fe29b2cfd7750) |\n| | Show the system alert when Bluetooth is off. Default is YES. [More...](#aa1372276d05adf851d6fe29b2cfd7750) |\n| ||\n| GNSErrorStateHandler | [microphonePermissionErrorHandler](/nearby/messages/ios/reference/interface_g_n_s_message_manager_params#ad2d25ff9a6bad90dd9c62dc17b765ff6) |\n| | The following error handlers are called (on the main thread) when the status of the error changes. [More...](#ad2d25ff9a6bad90dd9c62dc17b765ff6) |\n| ||\n| GNSErrorStateHandler | [bluetoothPermissionErrorHandler](/nearby/messages/ios/reference/interface_g_n_s_message_manager_params#a4d3c4e29e095463aac955746a5ecd871) |\n| | Bluetooth permission is denied. [More...](#a4d3c4e29e095463aac955746a5ecd871) |\n| ||\n| GNSErrorStateHandler | [bluetoothPowerErrorHandler](/nearby/messages/ios/reference/interface_g_n_s_message_manager_params#ae2bc4df92182fad9ba92e6c2d8938c1c) |\n| | Bluetooth is powered off. [More...](#ae2bc4df92182fad9ba92e6c2d8938c1c) |\n| ||\n| BOOL | [useBestAudioSessionCategory](/nearby/messages/ios/reference/interface_g_n_s_message_manager_params#a973c0bd7e77fb6c4f59440af88eaa9dc) |\n| | This parameter is relevant only if your app uses the audio medium for discovery. [More...](#a973c0bd7e77fb6c4f59440af88eaa9dc) |\n| ||\n\nProperty Detail\n---------------\n\n|---------------------------------------------------------------------------|--------------------------|\n| |----------------------------------| | - (BOOL) showBluetoothPowerAlert | | readwritenonatomicassign |\n\nShow the system alert when Bluetooth is off. Default is YES. \n\n|-----------------------------------------------------------------------------------------------------------------------------|------------------------|\n| |-----------------------------------------------------------| | - (GNSErrorStateHandler) microphonePermissionErrorHandler | | readwritenonatomiccopy |\n\nThe following error handlers are called (on the main thread) when the status of the error changes.\n\nA value of YES implies an error. Microphone permission is denied. \n\n|---------------------------------------------------------------------------------------------------------------------------|------------------------|\n| |----------------------------------------------------------| | - (GNSErrorStateHandler) bluetoothPermissionErrorHandler | | readwritenonatomiccopy |\n\nBluetooth permission is denied. \n\n|-----------------------------------------------------------------------------------------------------------------|------------------------|\n| |-----------------------------------------------------| | - (GNSErrorStateHandler) bluetoothPowerErrorHandler | | readwritenonatomiccopy |\n\nBluetooth is powered off. \n\n|-----------------------------------------------------------------------------------|--------------------------|\n| |--------------------------------------| | - (BOOL) useBestAudioSessionCategory | | readwritenonatomicassign |\n\nThis parameter is relevant only if your app uses the audio medium for discovery.\n\nWhen set to YES, Nearby will set the AVAudioSession category and options to the values that work best for Nearby: AVAudioSessionCategoryPlayAndRecord and AVAudioSessionCategoryOptionDefaultToSpeaker, respectively. If you set it to NO, the current category and options will be preserved and used by Nearby. This may result in the inability for Nearby to broadcast or record audio. For example, if your app uses AVAudioSessionCategoryAmbient, Nearby may not be able to listen to audio from nearby devices. If your app uses AVAudioSessionCategoryRecord, Nearby will not be able to broadcast audio to nearby devices. Default is YES."]]
