Parameter ini hanya relevan jika aplikasi Anda menggunakan media audio agar mudah ditemukan.
Jika disetel ke YA, fitur Di Sekitar akan menyetel opsi dan kategori AVAudioSession ke nilai yang paling sesuai untuk Nearby: AVAudioSessionCategoryPlayAndRecord dan AVAudioSessionCategoryOptionDefaultToSpeaker. Jika disetel ke TIDAK, kategori dan opsi saat ini akan dipertahankan dan digunakan oleh Berbagi Langsung. Hal ini dapat menyebabkan Di Sekitar tidak dapat menyiarkan atau merekam audio. Misalnya, jika aplikasi Anda menggunakan AVAudioSessionCategoryAmbient, fitur Di Sekitar mungkin tidak dapat mendengarkan audio dari perangkat di sekitar. Jika aplikasi Anda menggunakan AVAudioSessionCategoryRecord, Nearby tidak akan dapat menyiarkan audio ke perangkat di sekitar. Defaultnya adalah YA.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-13 UTC."],[[["\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."]]
