Ö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.
  • payload dü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 = false dö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.