Lebih lanjut ke konten utama
@capgo/capacitor-kemampuan Cahaya Aplikasi Perangkat Terbuka Sumber

Cahaya Plugin Capacitor

Kontrol kecerahan layar perangkat secara programatis dengan dukungan untuk kontrol spesifik aplikasi dan kontrol sistem-wide

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

Test di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Tautan QR pratinjau plugin Brightness code

Menggunakan @capgo/capacitor-brightness

Kontrol kecerahan layar pada iOS dan Android.

Pasang

bun add @capgo/capacitor-brightness
bunx cap sync

bunx cap sync menggandakan plugin asli code ke proyek-proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Import

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

API secara singkat

Metode Deskripsi
getBrightness Ambil tingkat kecerahan saat ini dari layar utama perangkat.
setBrightness Atur tingkat kecerahan layar utama perangkat.
getSystemBrightness Mendapatkan kecerahan layar sistem secara keseluruhan.
setSystemBrightness Mengatur kecerahan layar utama perangkat secara sistem. Memerlukan izin WRITE_SETTINGS pada Android. Ini juga mengubah mode kecerahan menjadi MANUAL.
getSystemBrightnessMode Mendapatkan mode kecerahan sistem saat ini (otomatis atau manual). Memerlukan izin WRITE_SETTINGS pada Android.
setSystemBrightnessMode Mengatur mode kecerahan sistem (otomatis atau manual). Memerlukan izin WRITE_SETTINGS pada Android.
isUsingSystemBrightness Mengecek apakah aktivitas saat ini menggunakan nilai kecerahan sistem secara sistem.
restoreSystemBrightness Reset pengaturan kecerahan aktivitas saat ini untuk menggunakan nilai sistem-wide.
isAvailable Periksa apakah Kecerahan API tersedia pada perangkat saat ini.
checkPermissions Periksa izin pengguna untuk mengakses kecerahan sistem.
requestPermissions Minta izin untuk mengakses kecerahan sistem. Pada Android, ini membuka pengaturan sistem untuk memberikan izin WRITE_SETTINGS.

Contoh

getBrightness()

Ambil tingkat kecerahan saat ini dari layar utama perangkat.

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

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

setBrightness()

Atur tingkat kecerahan layar utama perangkat.

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

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

getSystemBrightness()

Mendapatkan kecerahan layar sistem-wide.

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

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

setSystemBrightness()

Atur kecerahan layar sistem secara keseluruhan. Memerlukan izin WRITE_SETTINGS pada Android. Ini juga mengubah mode kecerahan menjadi MANUAL.

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

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

getSystemBrightnessMode()

Ambil mode kecerasan sistem saat ini (otomatis atau manual). Memerlukan izin WRITE_SETTINGS pada Android.

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

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

setSystemBrightnessMode()

Atur mode kecerasan sistem (otomatis atau manual). Memerlukan izin WRITE_SETTINGS pada Android.

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

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

Daftar di atas menampilkan 11 metode inti. Bantuan pemanggil dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat dalam repository GitHub.

Referensi lengkap

Teruskan dari Menggunakan @capgo/capacitor-brightness

Jika Anda menggunakan Menggunakan @capgo/capacitor-brightness Untuk merencanakan perilaku media dan antarmuka native, hubungkannya dengan @capgo/capacitor-kecerahan untuk detail implementasi di @capgo/capacitor-brightness Mulai Menggunakan untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-aktivitas-hidup untuk kemampuan asli di Menggunakan @capgo/capacitor-aktivitas-hidup, @capgo/capacitor-aktivitas-hidup untuk detail implementasi di @capgo/capacitor-aktivitas-hidup, dan Menggunakan @capgo/capacitor-pemain-video untuk kemampuan asli di Menggunakan @capgo/capacitor-pemain-video.

FAQ

FAQ Plugin Brightness

Bagaimana cara menginstal plugin Brightness di sebuah aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-brightness" (atau "npm install @capgo/capacitor-brightness"), kemudian jalankan "bunx cap sync" agar projek iOS dan Android dapat menangkap native code. Import dari "@capgo/capacitor-brightness" di aplikasi code.

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

Ya. Brightness adalah sebuah paket Capacitor, sehingga dapat 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?

Capgo plugin mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menampilkan versi yang masih dipelihara.

Apakah @capgo/capacitor-brightness gratis dan terbuka sumber?

Ya. Sumber code tersedia secara publik di GitHub di https://github.com/Cap-go/capacitor-brightness/ dan paketnya dapat diinstal secara gratis dari npm. Laporan bug dan permintaan pull selalu welcome.

Apakah saya dapat memperbarui code yang menggunakan Brightness tanpa melalui ulasan App Store?

Menginstal atau mengupgrade plugin mengubah native code, sehingga memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat dikirimkan secara instan dengan Capgo live updates.

Kirim perubahan Brightness tanpa menunggu tinjauan aplikasi

Saat plugin sudah ada di toko aplikasi Anda, Capgo pembaruan hidup memindahkan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit.

Mulai dengan Capgo