RC Battery List Item Widget

RC Battery List Item Widget is a LABEL type of widget which will display the current battery level of the remote controller. Following are examples of the widget states:

Disconnected

Normal

Low Battery

Usage

<dji.ux.beta.core.listitemwidget.rcbattery.RCBatteryListItemWidget
     android:id="@+id/rc_battery_list_item"
     android:layout_width="match_parent"
     android:layout_height="wrap_content"/>

Customizations

The UI elements can be customized to match the style of the user's application. The customizations can be done using attributes in XML or programmatically using the APIs. The widget supports all the customizations that its parent LABEL widget supports.

XML Example

<dji.ux.beta.core.listitemwidget.rcbattery.RCBatteryListItemWidget
     android:id="@+id/rc_battery_list_item"
     android:layout_width="match_parent"
     android:layout_height="wrap_content"
     android:background="@color/gray"
     app:uxsdk_list_item_title_text_color="@color/black"
     app:uxsdk_list_item_normal_color="@color/green"
     app:uxsdk_list_item_error_color="@color/orange"/>

Java Example

RCBatteryListItemWidget rcBatteryListItemWidget = findViewById(R.id.rc_battery_list_item);
rcBatteryListItemWidget.setListItemTitleTextColor(getResources().getColor(R.color.black));
rcBatteryListItemWidget.setBackgroundColor(getResources().getColor(R.color.gray));
rcBatteryListItemWidget.setNormalValueColor(getResources().getColor(R.color.green));
rcBatteryListItemWidget.setErrorValueColor(getResources().getColor(R.color.orange));

Kotlin Example

val rcBatteryListItemWidget = findViewById<RCBatteryListItemWidget>(R.id.rc_battery_list_item)
rcBatteryListItemWidget.listItemTitleTextColor = resources.getColor(R.color.black)
rcBatteryListItemWidget.setBackgroundColor(resources.getColor(R.color.gray))
rcBatteryListItemWidget.normalValueColor = resources.getColor(R.color.green)
rcBatteryListItemWidget.errorValueColor = resources.getColor(R.color.orange)

Hooks

The widget provides hooks for the users to add functionality based on the state changes in the widget. The RCBatteryListItemWidget provides the following hooks

1. RCBatteryListItemState - Provides hooks in events received by the widget from the widget model.
   • data class ProductConnected(val isConnected: Boolean) : RCBatteryListItemState() - Event when the product is connected or disconnected.
   • data class RCBatteryStateUpdate(val rcBatteryState: RCBatteryState) : RCBatteryListItemState() - Event when the RC battery level is updated.

The user can subscribe to this using public override fun getWidgetStateUpdate(): Flowable<RCBatteryListItemState>