Xamarin Essentials: Check Battery Status

Pada tutorial kali ini kita akan menggunakan salah satu fitur pada Xamarin Esseintials API untuk mengakses status Battery dari aplikasi yang kita buat.

Dengan menggunakan Battery Status API kita dapat melakukan pengecekan ketika device terkoneksi dengan A/C Power atau status battery sudah low, dan status lainnya.

1. Anda juga dapat mengambil informasi battery status menggunakan API Xamarin Essentials. Informasi dati battery yang dapat diambil adalah:

    • · Battery dalam keadaan di charging
    • · Battery dalam keadaan Full
    • · Battery dalam keadaan tidak dicharging
    • · Power pada device dalam keadaan dicharge atau menggunakan battery
    • · Deteksi bila battery masuk dalam keadaan Energy Saver.

2. Pada android project tambahkan kode berikut untuk mengijinkan aplikasi untuk mengakses battery status. Buka file AssemblyInfo.cs pada Properties untuk menambahkan konfigurasi berikut ini:

image

[assembly: UsesPermission(Android.Manifest.Permission.BatteryStats)]

3. Buat halaman dengan nama XEBatteryInfo, kemudian tambahkan kode berikut:

        <StackLayout>
            <Button x:Name="btnBatteryStatus" Text="Cek Status" Clicked="btnBatteryStatus_Clicked" />
        </StackLayout>

4. Kemudian tambahkan kode berikut ini:

        public XEBatteryInfo()
        {
            InitializeComponent();
            Battery.BatteryInfoChanged += Battery_BatteryInfoChanged;
            Battery.EnergySaverStatusChanged += Battery_EnergySaverStatusChanged; 
        }

        private async void Battery_EnergySaverStatusChanged(object sender, EnergySaverStatusChangedEventArgs e)
        {
            //bisa on,off, atau Unknown
            var status = e.EnergySaverStatus;
            await DisplayAlert("Keterangan",$"Energy Status:{status}","OK");
        }

        private async void Battery_BatteryInfoChanged(object sender, BatteryInfoChangedEventArgs e)
        {
            var level = e.ChargeLevel;
            var state = e.State;
            var source = e.PowerSource;
            await DisplayAlert("OK",$"Reading: Level: {level}, State: {state}, Source: {source}","OK");
        }

        private async void btnBatteryStatus_Clicked(object sender, EventArgs e)
        {
            var level = Battery.ChargeLevel; // returns 0.0 to 1.0 or 1.0 when on AC or no battery.

            var state = Battery.State;
            var keterangan = string.Empty;
            switch (state)
            {
                case BatteryState.Charging:
                    keterangan += "Battery di Charge\n";
                    break;
                case BatteryState.Full:
                    keterangan += "Battery sudah Penuh\n";
                    break;
                case BatteryState.Discharging:
                case BatteryState.NotCharging:
                    keterangan += "Battery tidak di charge\n";
                    break;
                case BatteryState.NotPresent:
                case BatteryState.Unknown:
                    keterangan += "Status battery tidak ditemukan\n";
                    break;
            }

            var source = Battery.PowerSource;

            switch (source)
            {
                case BatteryPowerSource.Battery:
                    keterangan += "Menggunakan Battery\n";
                    break;
                case BatteryPowerSource.AC:
                    keterangan += "Menggunakan AC Power\n";
                    break;
                case BatteryPowerSource.Usb:
                    keterangan += "Charge menggunakan Usb\n";
                    break;
                case BatteryPowerSource.Wireless:
                    keterangan += "Charge menggunakan Wireless\n";
                    break;
                case BatteryPowerSource.Unknown:
                    keterangan += "Charge tidak diketahui\n";
                    break;
            }

            await DisplayAlert("Keterangan", keterangan, "OK");
        }
    }

5. Kemudian jalankan aplikasi pada device untuk melihat hasilnya

image

Xamarin Essentials: App Information

Pada tutorial kali ini kita akan mencoba menggunakan Xamarin Essentials untuk mengambil informasi dari aplikasi mobile yang sudah kita buat.

Untuk mengambil informasi dari aplikasi, ikuti langkah-langkah berikut ini:

1. Dengan menggunakan API ini anda dapat mengetahui informasi dari aplikasi.

1. Anda dapat mengambil informasi yang ada oada AndroidManifest.xml seperti:

    • · Build – android:versionCode in manifest node
    • · Name – android:label in the application node
    • · PackageName: package in the manifest node
    • · VersionString – android:versionName in the application node

3. Pada project SampleXamarinEssentials tambahkan halaman xaml baru dengan nama XEAppInformation.

4. Kemudian tambahkan xaml kode berikut:

    <ContentPage.Content>
        <StackLayout>
            <Button x:Name="btnAppName" Text="Nama Aplikasi" Clicked="btnAppName_Clicked" />
            <Button x:Name="btnPackageName" Text="Nama Package" Clicked="btnPackageName_Clicked" />
            <Button x:Name="btnVersion" Text="Nama Versi" Clicked="btnVersion_Clicked" />
            <Button x:Name="btnBuildNum" Text="Build Number" Clicked="btnBuildNum_Clicked" />
        </StackLayout>
    </ContentPage.Content>

5. Kemudian tambahkan kode berikut untuk menampilkan informasi aplikasi.

        private async void btnAppName_Clicked(object sender, EventArgs e)
        {
            var appName = AppInfo.Name;
            await DisplayAlert("Keterangan", $"Nama Aplikasi: {appName}", "OK");
        }

        private async void btnPackageName_Clicked(object sender, EventArgs e)
        {
            await DisplayAlert("Keterangan", $"Nama Package: {AppInfo.PackageName}", "OK");
        }

        private async void btnVersion_Clicked(object sender, EventArgs e)
        {
            await DisplayAlert("Keterangan", $"Nama Versi: {AppInfo.VersionString}", "OK");
        }

        private async void btnBuildNum_Clicked(object sender, EventArgs e)
        {
            await DisplayAlert("Keterangan", $"Build Number: {AppInfo.BuildString}", "OK");
        }
        private async void btnAppName_Clicked(object sender, EventArgs e)
        {
            var appName = AppInfo.Name;
            await DisplayAlert("Keterangan", $"Nama Aplikasi: {appName}", "OK");
        }

        private async void btnPackageName_Clicked(object sender, EventArgs e)
        {
            await DisplayAlert("Keterangan", $"Nama Package: {AppInfo.PackageName}", "OK");
        }

        private async void btnVersion_Clicked(object sender, EventArgs e)
        {
            await DisplayAlert("Keterangan", $"Nama Versi: {AppInfo.VersionString}", "OK");
        }

        private async void btnBuildNum_Clicked(object sender, EventArgs e)
        {
            await DisplayAlert("Keterangan", $"Build Number: {AppInfo.BuildString}", "OK");
        }

6. Jalankan aplikasi pada devices/emulator dengan menekan tombol F5, maka akan dihasilkan tampilan sebagai berikut:

image

Xamarin Essentials: Cara Instalasi

Xamarin Essentials menyediakan satu API yang dapatbekerja dengan IOS, Android, dan aplikasi UWP yang dapat diakses dari satu share code. Xamarin Essentials menyediakan banyak feature yang dapat digunakan seperti:

  • · Accelerometer
  • · App Information
  • · Barometer
  • · Battery
  • · Clipboard
  • · Color Converters
  • · Compass
  • · Connectivity
  • · Detect Shake
  • · Device Display Information
  • · Device Information
  • · Email
  • · File System Helpers
  • · Flashlight
  • · Geocoding
  • · Geolocation
  • · Gyroscope
  • · Launcher
  • · Magnetometer
  • · MainThread
  • · Maps
  • · Open Browser
  • · Orientation Sensor
  • · Phone Dialer
  • · Platform Extensions
  • · Preferences
  • · Secure Storage
  • · Share
  • · SMS
  • · Text-to-Speech
  • · Unit Converters
  • · Version Tracking
  • · Vibrate

Untuk menggunakan library Xamarin Essentials, lakukan langkah-langkah sebagai berikut:

1. Buat project blank Xamarin Forms dengan nama SampleXamarinEssentials.

2. Kemudian klik kanan pada project Xamarin Forms kemudian pilih Nuget Package

image

3. Kemudian cari Xamarin Essentials. Jika anda menggunakan Visual Studio 2019, maka Xamarin Essentials sudah terpasang secara default ketika anda membuat project baru.

image