Library Pengontrol Game Bagian dari Android Game Development Kit.

Library Pengontrol Game, yang juga dikenal sebagai Paddleboat, membantu Anda menerapkan dukungan yang stabil untuk pengontrol game. Library menyediakan hal-hal berikut:

  • Callback untuk mendeteksi penyambungan dan pemutusan pengontrol
  • Informasi perangkat pengontrol, seperti gaya tombol dan tata letak
  • Data input pengontrol, distandardisasi berdasarkan desain pengontrol stik ganda modern
  • Penambahan fitur pada pengontrol yang didukung, seperti getaran, lampu, data sumbu gerakan, dan status baterai
  • Kemampuan untuk membaca input dari perangkat mouse virtual dan fisik
  • Kemampuan untuk menentukan data pemetaan pengontrol kustom untuk perangkat tertentu

Persyaratan kompatibilitas

Library Pengontrol Game memiliki persyaratan kompatibilitas minimum:

  • Android 4.1 (API level 16) atau yang lebih tinggi
  • Android NDK versi 17 atau yang lebih tinggi

Integrasi

Library Pengontrol Game didistribusikan dalam dua format: Sebagai library Jetpack untuk game yang menggunakan sistem build berbasis Gradle (termasuk Android Studio), dan sebagai file terpisah untuk game yang menggunakan sistem build kustom.

Untuk mengetahui contoh yang mengintegrasikan library Pengontrol Game, lihat repositori contoh game.

Library Jetpack

Halaman Jetpack Android Games memuat petunjuk integrasi untuk menambahkan dependensi library Pengontrol Game ke file build.gradle game Anda.

Rilis library Jetpack dari Pengontrol Game adalah library statis yang dibuat berdasarkan library bersama runtime C++.

Setelah mengupdate file build.gradle, Anda harus menambahkan baris berikut ke file CMakeLists.txt utama game Anda:

find_package(games-controller REQUIRED CONFIG)

Anda juga perlu menambahkan entri berikut ke daftar library dalam perintah target_link_libraries dari library bersama dan utama dari game Anda:

games-controller::paddleboat_static

File yang berbeda

Distribusi arsip .zip dari Android Game Development Kit menyertakan file header dan library untuk library Pengontrol Game. Agar dapat menggunakan library Game Controller, file berikut harus disertakan dalam project Anda:

  • File classes.jar yang berisi bagian bytecode Dalvik dari library Pengontrol Game. File ini ada di libs/classes.jar
  • File header antarmuka paddleboat.h. File ini ada di include/paddleboat/paddleboat.h
  • File library bersama libpaddleboat.so atau file library statis libpaddleboat-static.a. File ini ditemukan dalam subdirektori konfigurasi build pada direktori libs.

Subdirektori konfigurasi build pada direktori libs root dikategorikan berdasarkan:

  • Arsitektur ABI
  • API level Android Minimum
  • Versi Android NDK
  • Versi library runtime C++
  • Rilis atau debug konfigurasi build

Sebagai contoh, subdirektori arm64-v8a_API16_NDK21_cpp_shared_Release berisi file library untuk:

  • ARM 64-bit ABI
  • API level minimum 16
  • Di-build berdasarkan NDK versi 21
  • Di-build berdasarkan versi library bersama dari runtime C++
  • Konfigurasi build rilis

File libpaddleboat_static.a terletak langsung dalam subdirektori. File libpaddleboat.so terletak di lib/paddleboat/ dalam subdirektori.

Langkah berikutnya

Lihat panduan berikut untuk terus mengintegrasikan library Pengontrol Game ke dalam game: