Langsung ke konten utama
@capgo/capacitor-brightness API Perangkat Open source

Kecerahan plugin Capacitor

Kontrol kecerahan layar perangkat secara programatik dengan dukungan kontrol per aplikasi dan seluruh sistem.

Instal

bun add @capgo/capacitor-brightness bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-brightness
  • pnpm add @capgo/capacitor-brightness
  • yarn add @capgo/capacitor-brightness

Panduan

Cara menggunakan Brightness di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

QR pratinjau plugin Brightness code

Menggunakan @capgo/capacitor-brightness

Kontrol kecerahan layar di iOS dan Android.

Instal

bun add @capgo/capacitor-brightness
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

import { CapgoBrightness } from '@capgo/capacitor-brightness';

Sekilas tentang API

Metode Deskripsi
getBrightness Dapatkan level kecerahan layar utama perangkat saat ini.
setBrightness Atur level kecerahan layar utama perangkat.
getSystemBrightness Dapatkan brightness layar tingkat sistem.
setSystemBrightness Atur brightness layar tingkat sistem. Membutuhkan izin WRITE_SETTINGS di Android. Ini juga mengubah mode brightness ke MANUAL.
getSystemBrightnessMode Dapatkan mode brightness sistem saat ini (otomatis atau manual). Membutuhkan izin WRITE_SETTINGS di Android.
setSystemBrightnessMode Atur mode brightness sistem (otomatis atau manual). Membutuhkan izin WRITE_SETTINGS di Android.
isUsingSystemBrightness Cek apakah activity saat ini memakai nilai brightness tingkat sistem.
restoreSystemBrightness Reset pengaturan brightness pada activity saat ini agar memakai nilai tingkat sistem.
isAvailable Cek apakah Brightness API tersedia di perangkat saat ini.
checkPermissions Cek izin pengguna untuk mengakses kecerahan sistem.
requestPermissions Minta izin untuk mengakses kecerahan sistem. Di Android, ini akan membuka pengaturan sistem untuk memberikan izin WRITE_SETTINGS.

Contoh

getBrightness()

Dapatkan level kecerahan layar utama perangkat saat ini.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getBrightness();
console.log(result);

setBrightness()

Atur level kecerahan layar utama perangkat.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

await CapgoBrightness.setBrightness({ brightness: 0.5 });

getSystemBrightness()

Dapatkan brightness layar tingkat sistem.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getSystemBrightness();
console.log(result);

setSystemBrightness()

Atur brightness layar tingkat sistem. Membutuhkan izin WRITE_SETTINGS di Android. Ini juga mengubah mode brightness ke MANUAL.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });

getSystemBrightnessMode()

Dapatkan mode brightness sistem saat ini (otomatis atau manual). Membutuhkan izin WRITE_SETTINGS di Android.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);

setSystemBrightnessMode()

Atur mode brightness sistem (otomatis atau manual). Membutuhkan izin WRITE_SETTINGS di Android.

import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';

await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });

Tabel di atas mencantumkan 11 metode inti. Helper listener dan versi, serta kontrak lengkap dari setiap metode, semuanya didokumentasikan di repositori GitHub.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-brightness

Jika Anda menggunakan Menggunakan @capgo/capacitor-brightness untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan @capgo/capacitor-brightness untuk detail implementasi di @capgo/capacitor-brightness, Panduan Memulai untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, dan Menggunakan @capgo/capacitor-video-player untuk kapabilitas native saat menggunakan @capgo/capacitor-video-player.

FAQ

FAQ plugin Brightness

Bagaimana cara install plugin Brightness di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-brightness" (atau "npm install @capgo/capacitor-brightness"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mengenali code native. Import dari "@capgo/capacitor-brightness" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-brightness bisa digunakan dengan React, Vue, dan Angular?

Ya. Brightness adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-brightness?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-brightness gratis dan open source?

Ya. Source code bersifat publik di GitHub pada https://github.com/Cap-go/capacitor-brightness/ dan package ini gratis di-install dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya update code yang menggunakan Brightness tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Brightness tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo