Game Controller Library   Một phần của Android Game Development Kit.

Thư viện Tay điều khiển trò chơi, còn gọi là Paddleboat, giúp bạn hỗ trợ mạnh mẽ cho các tay điều khiển trò chơi. Thư viện Tay điều khiển trò chơi được phân phối dưới dạng thư viện Jetpack cho các trò chơi sử dụng hệ thống xây dựng dựa trên Gradle (bao gồm cả Android Studio). Thư viện này cung cấp những nội dung sau:

  • Lệnh callback (gọi lại) để phát hiện hoạt động kết nối và ngắt kết nối tay điều khiển
  • Thông tin thiết bị điều khiển, bao gồm cả bố cục và kiểu nút
  • Dữ liệu đầu vào của tay điều khiển, được chuẩn hoá theo thiết kế tay điều khiển gậy kép hiện đại
  • Các tính năng mở rộng trên tay điều khiển được hỗ trợ, bao gồm rung, đèn, dữ liệu trục chuyển động và trạng thái pin
  • Khả năng đọc dữ liệu đầu vào từ các thiết bị chuột thực và ảo
  • Khả năng chỉ định dữ liệu ánh xạ tay điều khiển tuỳ chỉnh cho các thiết bị cụ thể

Yêu cầu về khả năng tương thích

Thư viện Tay điều khiển trò chơi có các yêu cầu về khả năng tương thích tối thiểu như sau:

  • Android 4.4 (API cấp 19) trở lên
  • Android NDK phiên bản 21 trở lên

Tích hợp

Trang Jetpack Android Games có hướng dẫn về việc tích hợp để thêm phần phụ thuộc thư viện Tay điều khiển trò chơi vào tệp build.gradle của trò chơi.

Bản phát hành thư viện Jetpack của Tay điều khiển trò chơi là một thư viện tĩnh được xây dựng dựa trên thư viện chia sẻ thời gian chạy C++.

Sau khi cập nhật tệp build.gradle, bạn cần thêm dòng sau đây vào tệp CMakeLists.txt chính của trò chơi:

find_package(games-controller REQUIRED CONFIG)

Ngoài ra, bạn cần thêm mục nhập sau vào danh sách thư viện trong lệnh target_link_libraries của thư viện chia sẻ chính của trò chơi.

games-controller::paddleboat_static

Để tìm hiểu về một mẫu tích hợp thư viện Tay điều khiển trò chơi, hãy xem kho lưu trữ trò chơi-mẫu.

Các bước tiếp theo

Hãy xem các hướng dẫn sau để tiếp tục tích hợp thư viện Tay điều khiển trò chơi vào trò chơi: