Özel uygulamalar
Tarayıcı köprüsü
Uygulama sayfanın kullandığı Pocketbook nesnesi: tema, renk ve sinyal içeren context, server aksiyonlarına istekler, Lua'dan gelen mesajlar ve ana sayfaya dönüş.
Uygulamanın sayfası, defterin içindeki bir çerçevede kendi resource'undan çalışır (https://cfx-nui-<senin-resource>/...). Defterle, fx-pocketbook içinde gelen sdk/pocketbook.js üzerinden konuşur. Onu sayfa klasörüne kopyala ve kendi script'inden önce yükle:
html<script src="pocketbook.js"></script>
<script src="app.js"></script>
window.Pocketbook nesnesini tanımlar.
| Üye | Ne yapar |
|---|---|
Pocketbook.version |
1 |
Pocketbook.context |
Son context ya da ilki gelmeden önce null |
Pocketbook.onContext(fn) |
Bir context biliniyorsa fn(context) fonksiyonunu hemen, sonra her değişiklikte çağırır. Durduran bir fonksiyon döndürür. |
Pocketbook.onMessage(fn) |
Lua'dan gelen her SendCustomAppMessage için fn(data) çağırır. Durduran bir fonksiyon döndürür. |
Pocketbook.request(action, payload) |
Server aksiyonlarından birini çalıştırır. Sonuç tablosunun promise'ini döndürür. |
Pocketbook.home() |
Uygulamadan çıkar ve defterin ana sayfasına gider. |
#Context
Defter context'i sayfa yüklenince ve defterin rengi ya da sinyal değişince yeniden gönderir.
jsPocketbook.onContext((context) => {
document.documentElement.style.setProperty('--ink', context.colors.ink);
document.documentElement.style.setProperty('--muted', context.colors.muted);
document.documentElement.style.setProperty('--accent', context.colors.accent);
document.querySelector('#bars').textContent = context.signal;
});
| Alan | Nedir |
|---|---|
version |
1 |
theme |
Defterin rengi: standard, dark, pink, white, red, darkred, forest, midnight, tobacco, sand, mustard, slate, olive, teal ya da plum |
colors.ink |
Yazılar için ana mürekkep rengi |
colors.muted |
İkincil yazılar ve çizgiler için daha açık mürekkep |
colors.accent |
Vurgu mürekkebi |
signal |
Sinyal çubukları, 0 ile 5 arası |
preview |
Defter oyunda değil de önizleme için normal bir tarayıcıda çalışıyorsa true |
İstek göndermeden önce ilk context'i bekle. Daha önce gönderilen istekler hemen { ok: false } döndürür. Context nesnesi dondurulmuştur; oku, değiştirme.
#İstekler
jsconst result = await Pocketbook.request('balance', { account: 'main' });
if (!result.ok) showError(result.error);
action, [RegisterApplication](/phone/docs/pocketbook/exports/server/custom-apps) export'una verdiğin fonksiyonlardan birinin adıdır: harf ve rakam, harfle başlar, en fazla 32 karakter.payloaddüz bir nesnedir. İstekle birlikte JSON olarak 32 KiB'ın ve 8 seviye derinliğin altında kalmalıdır.- Promise her zaman çözülür, asla reddedilmez. Hatalar
{ ok: false, error }olarak gelir: - defter henüz context göndermediyse,
- zaten 4 istek bekliyorsa,
- 15 saniye içinde cevap gelmezse,
- server reddettiyse (karakter yok, defter item'ı yok, uygulama kurulu değil, başka bir istek hâlâ çalışıyor),
- aksiyonun
ok = falsedöndürdüyse. - Zaman aşımı, aksiyonun server'da başarısız olduğu anlamına gelmez. Yazma işlemlerinde payload içinde sabit bir nonce gönder ve yeniden deneme sunmadan önce kaydedilmiş sonucu oku.
#Lua'dan gelen mesajlar
jsconst stop = Pocketbook.onMessage((data) => {
if (data?.kind === 'hint') showHint(String(data.text));
});
Mesajlar yalnızca sayfa açıkken gelir. Saklanmazlar.
#Sayfadan çıkış
Oyuncu başka bir uygulamaya geçtiğinde ya da defteri kapattığında çerçeve yok edilir. Dinleyicilerini ve zamanlayıcılarını durdur:
jsconst stopContext = Pocketbook.onContext(applyColours);
const stopMessage = Pocketbook.onMessage(onMessage);
window.addEventListener('pagehide', () => { stopContext(); stopMessage(); }, { once: true });
#Çerçeve
- Çerçeve script çalıştırabilir. Başka sayfa açan bağlantılar, açılır pencereler ve defterin yönlendirilmesi engellenir.
- Köprü yalnızca defter penceresinden gelen mesajları kabul eder; defter de yalnızca senin resource'unun açık çerçevesinden gelen mesajları kabul eder.
- Kendi resource'undaki yazı tiplerini ve görselleri kullan; hiçbir şeyin internetten gelmesi gerekmez.
- Sayfa defterin kâğıdının üzerine çizilir. Her defter rengine uysun diye arka planı şeffaf bırak ve context renklerini kullan.