Galat

Setiap kode galat di SDK: apa yang terjadi dan apa yang perlu dilakukan.

Setiap kegagalan di SDK adalah satu jenis galat dengan kode, pesan, satu kalimat tentang apa yang harus dilakukan, dan tautan ke entrinya di sini. Kodenya sama di Android, Apple, web, dan C. Pesan dan baris tentang apa yang perlu dilakukan tetap dalam bahasa Inggris, persis seperti yang dikeluarkan SDK.

26 kode, SDK 3.0.0

invalid_argument

Pesan: Invalid argument: {detail}.
Yang perlu dilakukan: Pass a value the API accepts: a context or head name the model lists, a sample rate the SDK can resample, a surah from 1 to 114 with ayahs inside it, a rule name of lower-case letters, digits and underscores.

invalid_key

Pesan: Quran Lab does not accept this key.
Yang perlu dilakukan: Copy the key for this app and platform again from sdk.quranlab.ai; a revoked key has to be replaced by a new one there.
Di perangkat: Jika server menjawab bahwa kunci sudah dicabut atau tidak dikenal, SDK juga berhenti menjalankan model dan menghapusnya dari perangkat. Setelah server kembali menerima sebuah kunci, model diunduh lagi, seperti pada instalasi pertama.

sdk_too_old

Pesan: This key needs SDK {version} or later; this is {sdk}.
Yang perlu dilakukan: Upgrade the TajweedFormer SDK to {version} or later (the min_sdk of the server's answer), with the install line of the README.

server_rejected

Pesan: Quran Lab refused this app: {detail}.
Yang perlu dilakukan: Check in sdk.quranlab.ai that the key belongs to this app id and platform and that the app is not blocked.

Jika penolakan menyebut salah satu alasan ini, galat tetap memakai kode ini, dengan pesan dan langkah perbaikan dari alasan tersebut.

Alasan: developer_not_approved
Pesan: The account behind this key has no access to Quran Lab yet (developer_not_approved).
Yang perlu dilakukan: Open https://sdk.quranlab.ai/start with the account that owns the key and finish the access request; the key works as soon as access is given.
Di perangkat: SDK juga berhenti menjalankan model dan menghapusnya dari perangkat. Setelah server kembali menerima kunci dan aplikasinya, model diunduh lagi, seperti pada instalasi pertama.

Alasan: not_a_member
Pesan: The account that made this key is not a member of the workspace that owns the app (not_a_member).
Yang perlu dilakukan: Ask an owner of that workspace on sdk.quranlab.ai to add the account, or make a new key from an account that is a member.

Alasan: key_type_mismatch
Pesan: This key is of the wrong type for this platform (key_type_mismatch).
Yang perlu dilakukan: Use an apps key on Android and iOS, a desktop key on macOS, Windows and Linux, and a web key in a browser page; sdk.quranlab.ai makes each of them under the same app.
Di perangkat: SDK juga berhenti menjalankan model dan menghapusnya dari perangkat. Setelah server kembali menerima kunci dan aplikasinya, model diunduh lagi, seperti pada instalasi pertama.

Alasan: origin_not_allowed
Pesan: This page's origin, {origin}, is not on the key (origin_not_allowed).
Yang perlu dilakukan: Add this page's origin (scheme, host and port, for example https://app.example.org) to the key on its page at https://sdk.quranlab.ai/keys.
Di perangkat: SDK juga berhenti menjalankan model dan menghapusnya dari perangkat. Setelah server kembali menerima kunci dan aplikasinya, model diunduh lagi, seperti pada instalasi pertama.

Alasan: app_not_allowed
Pesan: This key belongs to another app (app_not_allowed).
Yang perlu dilakukan: A key works for the first app that used it. Make a key for this app at https://sdk.quranlab.ai/keys, or allow this app's identifier on the key's page.
Di perangkat: SDK juga berhenti menjalankan model dan menghapusnya dari perangkat. Setelah server kembali menerima kunci dan aplikasinya, model diunduh lagi, seperti pada instalasi pertama.

Alasan: app_blocked
Pesan: Quran Lab does not serve this app at the moment: it is blocked by Quran Lab or paused by its developer (app_blocked).
Yang perlu dilakukan: Open the app's page on sdk.quranlab.ai: unpause the app there, or read the reason for the block and write to Quran Lab from the account that owns the app.
Di perangkat: SDK juga berhenti menjalankan model dan menghapusnya dari perangkat. Setelah server kembali menerima kunci dan aplikasinya, model diunduh lagi, seperti pada instalasi pertama.

Alasan: environment_mismatch
Pesan: This key's environment (development or production) does not match this app (environment_mismatch).
Yang perlu dilakukan: Use the development key in the builds you run yourself and the production key in the build you publish; both are on the app's page on sdk.quranlab.ai.

Alasan: local_needs_development_key
Pesan: This page runs on {origin}, and a production key does not work on a local address (local_needs_development_key).
Yang perlu dilakukan: Use this app's development key for local work, with http://localhost:* among its origins (https://sdk.quranlab.ai/keys); keep the production key for the deployed site.

Alasan: model_attestation_required
Pesan: Quran Lab could not confirm that this is the app as its store delivers it, running on a real device, and does not send it the model (model_attestation_required).
Yang perlu dilakukan: Run the app as the store or TestFlight installs it, on a real device: a simulator, an emulator and a changed app or device cannot be confirmed. While you develop, use this app's development key, which is not asked for this.

Alasan: model_not_allowed
Pesan: Quran Lab does not send model files to this platform at the moment (model_not_allowed).
Yang perlu dilakukan: Nothing in the app is wrong. See sdk.quranlab.ai for the state of this platform, or write to Quran Lab from the account that owns the app.

client_exists

Pesan: This process already has a TajweedClient.
Yang perlu dilakukan: Keep the first client and reuse it, or close it before making another.

model_unavailable

Pesan: Quran Lab has no model build for SDK {sdk} yet.
Yang perlu dilakukan: Nothing to change in the app: call model() again later, and check client.diagnose() and sdk.quranlab.ai for the model builds of this SDK version.

needs_connection

Pesan: The model is not on this device yet.
Yang perlu dilakukan: Connect once so the model can be downloaded; call prefetch() at app start so later starts work offline.

network_not_permitted

Pesan: This app is not allowed to use the network.
Yang perlu dilakukan: Android: keep the INTERNET permission that the SDK's manifest declares (take out a tools:node="remove" for android.permission.INTERNET). A sandboxed Mac app: turn on Outgoing Connections (Client) under App Sandbox.

download_failed

Pesan: The model download stopped: {detail}.
Yang perlu dilakukan: Call model() or prefetch() again when the network is back; the download resumes where it stopped.

storage_full

Pesan: Not enough free space for the model: {needed} bytes needed, {available} free.
Yang perlu dilakukan: Free that much space on the device, or call removeModels() to drop model versions that are no longer used.

storage_failed

Pesan: The SDK's folder cannot be read or written: {detail}.
Yang perlu dilakukan: Give the client a storage folder the app can write to, and make sure only one process uses it.

model_missing

Pesan: No model here: {detail}.
Yang perlu dilakukan: Let client.model() download the model: a model comes from Quran Lab's server through the Client, and a model folder that the Client did not download itself is not opened.

model_invalid

Pesan: The model folder is damaged: {detail}.
Yang perlu dilakukan: Call removeModels() and then model() to download the model again.

signature_invalid

Pesan: The model's manifest is not signed by Quran Lab.
Yang perlu dilakukan: Use only model files from cdn.quranlab.ai; call removeModels() and then model() to download them again.

checksum_mismatch

Pesan: A model file differs from the manifest: {file}.
Yang perlu dilakukan: Call removeModels() and then model() to download the model again; if it repeats, the storage is failing.

model_incompatible

Pesan: This model build does not run on this SDK: {detail}.
Yang perlu dilakukan: Upgrade the SDK to the version the message names, or let client.model() pick the build for this SDK instead of opening a folder.

runtime_unsupported

Pesan: The SDK cannot run here: {detail}.
Yang perlu dilakukan: Run the app where the SDK is supported: {minimum}.

reference_missing

Pesan: The reference data is not on this device.
Yang perlu dilakukan: Call model.reference.fetch() once, with a connection, before asking for units.

session_open

Pesan: This model already has an open session.
Yang perlu dilakukan: Finish or cancel the open session before starting the next take.

session_closed

Pesan: The session has ended.
Yang perlu dilakukan: Start a new session with model.listen() or model.session() for the next take.

cancelled

Pesan: The take was cancelled.
Yang perlu dilakukan: Nothing to fix: cancel() was called, or the app's task was cancelled; start a new session for the next take.

engine_failed

Pesan: The engine failed: {detail}.
Yang perlu dilakukan: Call client.diagnose() and send the report to Quran Lab; a new session on the same model can be tried.

microphone_denied

Pesan: The microphone permission was refused.
Yang perlu dilakukan: Explain why the app listens and send the learner to the system settings; listen() asks again only where the platform allows it.

microphone_unavailable

Pesan: No microphone can be opened: {detail}.
Yang perlu dilakukan: Check that the device has an input and no other app holds it, then call listen() again.

interrupted

Pesan: The take ended on an interruption: {detail}.
Yang perlu dilakukan: Start a new session when the app has the audio again; what was heard so far is in the last chunk.

sharing_unavailable

Pesan: Sharing is not available for this app.
Yang perlu dilakukan: Nothing to call: Quran Lab switches sharing on per app; check client.sharing.isAvailable before showing sharing settings.