JVM και Android

Αυτή η σελίδα έχει μεταφραστεί από τα αγγλικά. Αν οι δύο διαφέρουν, η αγγλική σελίδα είναι η σωστή. Διαβάστε την αγγλική σελίδα

Το κιτ παίκτη Kotlin εκτελείται στη JVM, σε υπολογιστή και σε Android. Τα παιχνίδια Java χρησιμοποιούν το ίδιο κιτ μέσω της πρόσοψής του για Java. Τα παραδείγματα ακολουθούν ένα παιχνίδι libGDX, του οποίου ο βρόχος απόδοσης είναι το φυσικό σημείο για να αδειάζετε συμβάντα, και οι ίδιες κλήσεις ταιριάζουν σε οποιονδήποτε βρόχο παιχνιδιού.

Προσθήκη του κιτ και των εγγενών βιβλιοθηκών του

Το κιτ και οι εγγενείς βιβλιοθήκες του είναι ξεχωριστά artifacts στο Maven Central, οπότε προσθέστε και τα δύο. Ένα παιχνίδι για υπολογιστή προσθέτει το lingara-embed-natives-desktop, που περιέχει τις βιβλιοθήκες για Windows, macOS και Linux. Ένα module Android προσθέτει αντ’ αυτού το lingara-embed-natives-android, ένα AAR. Σε ένα έργο libGDX, οι εγγενείς βιβλιοθήκες υπολογιστή μπαίνουν στο module υπολογιστή και οι εγγενείς βιβλιοθήκες Android στο module Android.

Ένα παιχνίδι Kotlin εξαρτάται από το lingara-embed-kotlin· ένα παιχνίδι Java από το lingara-embed-java, την πρόσοψη.

Λήψη token από τον διακομιστή σας

Το κιτ δεν κρατά ποτέ κανένα μυστικό. Δώστε του τη διαδρομή token του δικού σας διακομιστή και την κεφαλίδα που μεταφέρει τη συνεδρία του παίκτη, και το κιτ στέλνει αίτημα σε αυτήν κάθε φορά που χρειάζεται token. Ο διακομιστής σας εκδίδει με ένα κιτ διακομιστή και απαντά με το token και τη λήξη του.

Άδειασμα συμβάντων στον βρόχο απόδοσης

Ο πυρήνας εκτελεί το δικτυακό του I/O στο δικό του νήμα και δεν καλεί ποτέ τον κώδικά σας. Στον βρόχο απόδοσης, στο νήμα του παιχνιδιού, αδειάστε ό,τι έχει φτάσει, το πολύ 256 συμβάντα κάθε φορά, και χειριστείτε το καθένα: μια ενημέρωση εξάσκησης, μια απάντηση NPC σε ροή, ένα σφάλμα. Σε Java, κάθε συμβάν πηγαίνει στην αντίστοιχη μέθοδο του visitor σας. Κλείστε το κιτ στο βήμα dispose του παιχνιδιού σας, το οποίο σταματά τον πυρήνα και τον αποδεσμεύει.

Δείτε Διάλογοι με NPC και αποτελέσματα εξάσκησης για το τι μεταφέρουν αυτά τα συμβάντα.

KotlinJava

Kotlin

// The kit, and the natives for the platform: natives-desktop in a libGDX lwjgl3 module, natives-android in its android module.
implementation("com.getlingara:lingara-embed-kotlin:0.1.0-alpha.6")
implementation("com.getlingara:lingara-embed-natives-desktop:0.1.0-alpha.6")

Java

<!-- The kit, and the natives for the platform (lingara-embed-natives-android in an Android module). -->
<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-embed-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>
<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-embed-natives-desktop</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

KotlinJava

Kotlin

// Your server mints the embed token; the kit POSTs {} here whenever it needs one.
private val lingara =
    LingaraEmbed.start(
        EmbedConfig(
            tokenSource =
                TokenSourceConfig.Http(
                    url = "https://my-game.example/lingara/token",
                    headers = listOf(Header("Authorization", Secret("Bearer $session"))),
                ),
            userAgentSuffix = "my-game/1.4",
        ),
    )

Java

// Your server mints the embed token; the kit POSTs {} here whenever it needs one.
lingara =
    LingaraEmbedJava.builder()
        .httpTokenSource(
            "https://my-game.example/lingara/token",
            Map.of("Authorization", "Bearer " + session))
        .userAgentSuffix("my-game/1.4")
        .build();

KotlinJava

Kotlin

// In render(), on the game thread: one crossing, at most 256 events.
fun render() {
    lingara.drain(256) { event ->
        when (event) {
            is EmbedEvent.Practice -> showPractice(event.snapshot.question?.prompt)
            is EmbedEvent.NpcTurn -> onNpcTurn(event.update)
            is EmbedEvent.Error -> println("Lingara error: ${event.error.message}")
            else -> Unit
        }
    }
}

// In dispose(): stops the core and frees it.
fun dispose() {
    lingara.close()
}

Java

// In render(), on the game thread: one crossing, at most 256 events, each to its visitor method.
void render() {
  lingara.drain(256, event -> LingaraEmbedJava.visit(event, visitor));
}

// In dispose(), or let try-with-resources do it.
@Override
public void close() {
  lingara.close();
}