Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# CarrierRoamingNtnListener

*** ** * ** ***

```
interface CarrierRoamingNtnListener
```

|---|
| [android.telephony.TelephonyCallback.CarrierRoamingNtnListener](https://developer.android.com/reference/kotlin/android/telephony/TelephonyCallback.CarrierRoamingNtnListener#) |

Interface for carrier roaming non-terrestrial network listener.

## Summary

| Public methods ||
|---|---|
| open [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | `https://developer.android.com/reference/kotlin/android/telephony/TelephonyCallback.CarrierRoamingNtnListener#onCarrierRoamingNtnAvailableServicesChanged(kotlin.IntArray)(availableServices: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int-array/index.html)` Callback invoked when carrier roaming non-terrestrial network available service changes. |
| open [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | `https://developer.android.com/reference/kotlin/android/telephony/TelephonyCallback.CarrierRoamingNtnListener#onCarrierRoamingNtnEligibleStateChanged(kotlin.Boolean)(eligible: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Callback invoked when carrier roaming non-terrestrial network eligibility changes. |
| abstract [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | `https://developer.android.com/reference/kotlin/android/telephony/TelephonyCallback.CarrierRoamingNtnListener#onCarrierRoamingNtnModeChanged(kotlin.Boolean)(active: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)` Callback invoked when carrier roaming non-terrestrial network mode changes. |
| open [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | `https://developer.android.com/reference/kotlin/android/telephony/TelephonyCallback.CarrierRoamingNtnListener#onCarrierRoamingNtnSignalStrengthChanged(android.telephony.satellite.NtnSignalStrength)(ntnSignalStrength: https://developer.android.com/reference/kotlin/android/telephony/satellite/NtnSignalStrength)` Callback invoked when carrier roaming non-terrestrial network signal strength changes. |

## Public methods

### onCarrierRoamingNtnAvailableServicesChanged

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
open fun onCarrierRoamingNtnAvailableServicesChanged(availableServices: IntArray): Unit
```

Callback invoked when carrier roaming non-terrestrial network available service changes.

| Parameters ||
|---|---|
| `availableServices` | [IntArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int-array/index.html): array of supported services. This value cannot be `null`. Value is one of the following: - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_UNKNOWN:kotlin.Int` - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_VOICE:kotlin.Int` - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_DATA:kotlin.Int` - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_SMS:kotlin.Int` - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_VIDEO:kotlin.Int` - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_EMERGENCY:kotlin.Int` - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_MMS:kotlin.Int` - `https://developer.android.com/reference/kotlin/android/telephony/NetworkRegistrationInfo#SERVICE_TYPE_EMERGENCY_SMS:kotlin.Int` |

### onCarrierRoamingNtnEligibleStateChanged

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
open fun onCarrierRoamingNtnEligibleStateChanged(eligible: Boolean): Unit
```

Callback invoked when carrier roaming non-terrestrial network eligibility changes.

| Parameters ||
|---|---|
| `eligible` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html): `true` when the device is eligible for satellite communication if all the following conditions are met: - Any subscription on the device supports P2P satellite messaging which is defined by `https://developer.android.com/reference/kotlin/android/telephony/CarrierConfigManager#KEY_SATELLITE_ATTACH_SUPPORTED_BOOL:kotlin.String` - `https://developer.android.com/reference/kotlin/android/telephony/CarrierConfigManager#KEY_CARRIER_ROAMING_NTN_CONNECT_TYPE_INT:kotlin.String` set to `https://developer.android.com/reference/kotlin/android/telephony/CarrierConfigManager#CARRIER_ROAMING_NTN_CONNECT_MANUAL:kotlin.Int` - The device is in `https://developer.android.com/reference/kotlin/android/telephony/ServiceState#STATE_OUT_OF_SERVICE:kotlin.Int`, not connected to Wi-Fi, and the hysteresis timer defined by `https://developer.android.com/reference/kotlin/android/telephony/CarrierConfigManager` is expired. |

### onCarrierRoamingNtnModeChanged

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
abstract fun onCarrierRoamingNtnModeChanged(active: Boolean): Unit
```

Callback invoked when carrier roaming non-terrestrial network mode changes.

| Parameters ||
|---|---|
| `active` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html): `true` If the device is connected to carrier roaming non-terrestrial network or was connected within the {CarrierConfigManager #KEY_SATELLITE_CONNECTION_HYSTERESIS_SEC_INT} duration, {code false} otherwise. |

### onCarrierRoamingNtnSignalStrengthChanged

Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
open fun onCarrierRoamingNtnSignalStrengthChanged(ntnSignalStrength: NtnSignalStrength): Unit
```

Callback invoked when carrier roaming non-terrestrial network signal strength changes.

| Parameters ||
|---|---|
| `ntnSignalStrength` | [NtnSignalStrength](https://developer.android.com/reference/kotlin/android/telephony/satellite/NtnSignalStrength): non-terrestrial network signal strength. This value cannot be `null`. |