Android Games

Hướng dẫn sử dụng

Thư viện Android Games sao chép SDK cho trò chơi Android được cung cấp dưới dạng tệp tải xuống loại nhị phân. Bạn có thể sử dụng thư viện Androidx thay vì tải và tích hợp SDK cho trò chơi Android vào bản dựng theo cách thủ công.

Để biết thêm thông tin về SDK cho trò chơi Android, hãy xem tài liệu về SDK và ghi chú phát hành SDK.

Bảng này liệt kê tất cả cấu phần phần mềm trong nhóm androidx.games.

Cấu phần phần mềm	Bản phát hành ổn định	Bản phát hành dùng thử	Bản phát hành beta	Bản phát hành alpha
games-activity	1.2.2	-	2.0.0-beta01	-
games-controller	-	-	2.0.0-beta01	-
games-frame-pacing	1.9.1	-	2.0.0-beta01	-
games-memory-advice	-	-	1.0.0-beta03	2.0.0-alpha01
games-text-input	-	-	2.0.0-beta01	-
games-performance-tuner	-	-	-	2.0.0-alpha02

Lần gần nhất cập nhật thư viện này: ngày 8 tháng 2 năm 2023

Yêu cầu

games-memory-advice

API MemoryAdvice yêu cầu bạn xây dựng ứng dụng bằng một trong các phiên bản NDK sau:

r20.*
r21.*
r23.*

Khai báo phần phụ thuộc

Để thêm phần phụ thuộc vào trò chơi, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle của ứng dụng hoặc mô-đun của bạn; thư viện games-activity đã tích hợp cùng một phiên bản của thư viện game-text-input, do đó các ứng dụng GameActivity không thể thêm phần phụ thuộc game-text-input nữa:

Groovy

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:1.9.1"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:1.2.2"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:"

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation "androidx.games:games-text-input:"
}

Kotlin

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab = true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation("androidx.games:games-frame-pacing:1.9.1")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:1.2.2")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:")

    // To use the Games Text Input Library
    // Do not include this if games-activity has been included
    implementation("androidx.games:games-text-input:")
}
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Thêm các thuộc tính Gradle

Bạn có thể sẽ phải thêm thuộc tính vào tệp gradle.properties (nằm trong cùng thư mục với tệp build.gradle của ứng dụng/mô-đun). Hãy tạo tệp gradle.properties nếu chưa có.

Nếu bạn đang sử dụng Android Studio 4.0, hãy đảm bảo gradle.properties chứa các dòng sau:

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Nếu bạn đang sử dụng Android Studio 4.1 trở lên, hãy đảm bảo gradle.properties chứa các dòng sau:

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

Thêm gói bằng CMake

Để có thể truy cập các gói SDK cho trò chơi Android đã nhập, hãy thêm những nội dung sau vào tệp CMakeLists.txt của ứng dụng chính:

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

Thao tác này sẽ cho phép bạn đưa các tệp tiêu đề trong SDK cho trò chơi Android vào mã nguồn của trò chơi:

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

Trong tệp CMakeLists.txt của ứng dụng chính, hãy tìm target_link_libraries dành cho thư viện chia sẻ chính. Thêm tệp đối chiếu vào thư viện tĩnh của SDK cho trò chơi Android để đưa vào thư viện chia sẻ:

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

Phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Hãy xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Games-Memory-Advice phiên bản 2.0.0

Phiên bản 2.0.0-alpha01

Ngày 8 tháng 2 năm 2023

Phát hành androidx.games:games-memory-advice:2.0.0-alpha01. Phiên bản 2.0.0-alpha01 bao gồm các thay đổi sau.

Các thay đổi về API

Số phiên bản lớn tăng thành 2.0.0 do quá trình tái cấu trúc tệp bản dựng

Sửa lỗi

Thay vì dừng hoạt động, một thông báo lỗi sẽ hiển thị nếu tài sản thư viện không được định cấu hình chính xác.

Games-Memory-Advice phiên bản 1.0.0

Phiên bản 1.0.0-beta03

Ngày 9 tháng 11 năm 2022

Phát hành androidx.games:games-memory-advice:1.0.0-beta03. Phiên bản 1.0.0-beta03 bao gồm các thay đổi sau.

Tính năng mới

Không có thay đổi mới nào

Phiên bản 1.0.0-beta01

Ngày 9 tháng 3 năm 2022

Phát hành androidx.games:games-memory-advice:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Không có thay đổi nào kể từ phiên bản 1.0.0-alpha01.

Phiên bản 1.0.0-alpha01

Ngày 23 tháng 2 năm 2022

Phát hành androidx.games:games-memory-advice:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Thư viện C này cung cấp cơ sở để truy vấn và nhận hàm gọi lại (callback) đối với các thay đổi trong trạng thái bộ nhớ của thiết bị đang chạy trò chơi.

Các thay đổi về API

Đây là bản phát hành đầu tiên của thư viện thông báo bộ nhớ. Hãy xem tiêu đề tại include/memory_advice/memory_advice.h để tải toàn bộ API.

Đóng góp bên ngoài

Thư viện này dựa theo nền tảng tensorflow. Có thể tìm giấy phép của nền tảng trên cũng như của các phần phụ thuộc bắc cầu (transitive dependency) tại https://github.com/tensorflow/tensorflow.

Games-Activity Phiên bản 2.0

Phiên bản 2.0.0-beta01

Ngày 8 tháng 2 năm 2023

Phát hành androidx.games:games-activity:2.0.0-beta01. Phiên bản 2.0.0-beta01 bao gồm các thay đổi sau.

Sửa lỗi

Khắc phục lỗi xử lý các nút hệ thống. (2a103e)

Phiên bản 2.0.0-alpha01

Ngày 11 tháng 1 năm 2023

Phát hành androidx.games:games-activity:2.0.0-alpha01 mà không có thay đổi nào. Phiên bản 2.0.0-alpha01 bao gồm các thay đổi sau.

Games-Activity Phiên bản 1.2

Phiên bản 1.2.2

Ngày 7 tháng 12 năm 2022

Phát hành androidx.games:games-activity:1.2.2. Phiên bản 1.2.2 bao gồm các thay đổi sau.

Sửa lỗi

Hiện tại, bạn có thể thiết lập số sự kiện chuyển động tối đa trong thời gian chạy.

Phiên bản 1.2.2-alpha01

Ngày 9 tháng 11 năm 2022

Phát hành androidx.games:games-activity:1.2.2-alpha01. Phiên bản 1.2.2-alpha01 bao gồm các thay đổi sau.

Các thay đổi về API

API hiện cũng chứa thông tin phiên bản dưới dạng GAMEACTIVITY_PACKED_VERSION. (I287e6)
Thêm lệnh gọi lại onContentRectChanged. Lệnh gọi lại (callback) này được gọi khi hình chữ nhật trong cửa sổ nơi nội dung cần được đặt thay đổi. (I81396)

Sửa lỗi

Khắc phục lỗi tràn bộ đệm sự kiện. Cả inputBuffer->keyEvents và motionEvents hiện đều là vùng đệm phân bổ động. (Ic00f6)
Có lỗi nhẹ khi hết bộ nhớ. Thêm chức năng xử lý lỗi realloc() trong quá trình thay đổi kích thước vùng đệm.

Phiên bản 1.2.1

Ngày 13 tháng 7 năm 2022

Phát hành androidx.games:games-activity:1.2.1. Phiên bản 1.2.1 bao gồm các thay đổi sau.

Sửa lỗi

Khắc phục các vấn đề liên quan đến việc thiếu tệp .aar trong bản phát hành trước.

Phiên bản 1.2.0

Ngày 15 tháng 6 năm 2022

Phát hành androidx.games:games-activity:1.2.0. Phiên bản 1.2.0 bao gồm các thay đổi sau.

Thay đổi quan trọng kể từ phiên bản 1.1.0

Cho phép các lớp dẫn xuất GameActivity xử lý việc tải thư viện gốc.
Luôn tải thư viện gốc trong GameActivity.onCreate.
Dự phòng để tải thư viện có tên "main" nếu không tìm thấy thư viện nào khác.

Phiên bản Games-Activity 1.1

Phiên bản 1.1.0

Ngày 23 tháng 2 năm 2022

Phát hành androidx.games:games-activity:1.1.0 và androidx.games:games-controller:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.0.0

Games Activity (Hoạt động Trò chơi):

WindowInsets nghe và truy vấn để phản hồi vết khía (notch) và IME
Thêm bộ lọc khoá và sự kiện chuyển động
Sửa các lỗi:
- Bổ sung thông báo bị thiếu để tương thích với NativeActivity
- Sửa chữ ký của onNativeWindowResized
- Sửa lỗi mất sự kiện đầu vào

Phiên bản 1.1.0-rc01

Ngày 9 tháng 2 năm 2022

Phát hành androidx.games:games-activity:1.1.0-rc01 và androidx.games:games-controller:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.1.0-beta03

Ngày 26 tháng 1 năm 2022

Phát hành androidx.games:games-activity:1.1.0-beta03. Phiên bản 1.1.0-beta03 bao gồm các thay đổi sau.

Sửa lỗi

Sửa chữ ký của onNativeWindowResized
Duy trì xử lý đối với cửa sổ gốc trong onSurfaceChanged

Phiên bản 1.1.0-beta02

Ngày 15 tháng 12 năm 2021

Phát hành androidx.games:games-activity:1.1.0-beta02. Phiên bản 1.1.0-beta02 bao gồm các thay đổi sau.

Sửa lỗi

Sửa điều kiện tranh đấu trong chế độ cài đặt bộ lọc sự kiện.

Phiên bản 1.1.0-beta01

Ngày 17 tháng 11 năm 2021

Phát hành androidx.games:games-activity:1.1.0-beta01. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Thêm tính năng hỗ trợ truy vấn các phần lồng ghép cửa sổ và nghe các thay đổi đối với phần lồng ghép. Tính năng này cho phép trò chơi tương tác với cửa sổ bật lên IME, đồng thời xử lý các phần lồng ghép vết cắt waterfall (thác nước) và vết cắt dành cho máy ảnh.

Các thay đổi về API

void GameActivity_getWindowInsets(GameActivity* activity, enum GameCommonInsetsType type, GameCommonInsets* insets);

Sửa lỗi

Tránh tiêu thụ tất cả sự kiện quan trọng: âm lượng, máy ảnh, v.v. hiện được truyền vào hệ thống.

Phiên bản 1.1.0-alpha01

Ngày 29 tháng 9 năm 2021

Phát hành androidx.games:games-activity:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Các thay đổi về API

Thêm lệnh gọi lại onContentRectChanged vào GameActivityCallbacks

Sửa lỗi

Các thông báo bị thiếu được thêm vào android_native_app_glue.h:
- APP_CMD_CONTENT_RECT_CHANGED
- APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner (Trình theo dõi hiệu suất trò chơi) 2.0

Phiên bản 2.0.0-alpha02

Ngày 8 tháng 2 năm 2023

Phát hành androidx.games:games-performance-tuner:2.0.0-alpha02. Phiên bản 2.0.0-alpha02 bao gồm các thay đổi sau.

Các thay đổi về API

Thêm API TuningFork_predictQualityLevels; việc này giúp dự đoán đúng mức chất lượng/thông số về độ chân thực sẽ sử dụng.

Games Performance Tuner (Trình theo dõi hiệu suất trò chơi) 1.6

Phiên bản 1.6.1-alpha01

Ngày 9 tháng 11 năm 2022

Phát hành androidx.games:games-performance-tuner:1.6.1-alpha01. Phiên bản 1.6.1-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Không có thay đổi mới nào

Phiên bản 1.6.0

Ngày 15 tháng 6 năm 2022

Phát hành androidx.games:games-performance-tuner:1.6.0. Phiên bản 1.6.0 bao gồm các thay đổi sau.

Các thay đổi quan trọng kể từ phiên bản 1.5.0

Sửa lỗi getpid trả về 0 khi đang cố lấy dữ liệu đo từ xa của bộ nhớ.
Đã ngăn StopLoadingGroup khi thực thi mà không có nhóm tải nào đang hoạt động.

Games Performance Tuner (Trình theo dõi hiệu suất trò chơi) 1.5.0

Phiên bản 1.5.0

Ngày 9 tháng 2 năm 2022

Phát hành androidx.games:games-performance-tuner:1.5.0. Phiên bản 1.5.0 bao gồm các thay đổi sau.

Các thay đổi quan trọng kể từ phiên bản 1.4.0

Thay đổi khoảng thời gian giữa các lần tải lên bằng cách lập trình, thay vì được mã hoá cứng trong chế độ cài đặt ban đầu.
- Thêm hàm: TuningFork_setAggregationStrategyInterval
Sửa lỗi hỏng bộ nhớ trong khoá API trên API<=23

Phiên bản 1.5.0-rc01

Ngày 26 tháng 1 năm 2022

Phát hành androidx.games:games-performance-tuner:1.5.0-rc01. Phiên bản 1.5.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

Sửa lỗi hỏng bộ nhớ trong khoá API trên API<=23

Phiên bản 1.5.0-beta02

Ngày 15 tháng 12 năm 2021

Phát hành androidx.games:games-performance-tuner:1.5.0-beta02. Phiên bản 1.5.0-beta02 bao gồm các thay đổi sau.

Các thay đổi về API

Xoá thay đổi có thể gây lỗi ABI khỏi TuningFork_Settings.

Phiên bản 1.5.0-beta01

Ngày 29 tháng 9 năm 2021

Phát hành androidx.games:games-performance-tuner:1.5.0-beta01. Phiên bản 1.5.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Không có thay đổi nào trong bản phát hành alpha. Bản phát hành đó bao gồm:
- Thay đổi khoảng thời gian giữa các lần tải lên bằng cách lập trình, thay vì được mã hoá cứng trong chế độ cài đặt ban đầu.

Các thay đổi về API

Không có thay đổi nào trong bản phát hành alpha. Bản phát hành đó bao gồm:
- Hàm mới: TuningFork_setAggregationStrategyInterval
- Trường mới trong TuningFork_Settings: aggregation_strategy_intervalms_or_count

Phiên bản 1.5.0-alpha01

Ngày 18 tháng 8 năm 2021

Phát hành androidx.games:games-performance-tuner:1.5.0-alpha01. Phiên bản 1.5.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Hiện bạn có thể thiết lập khoảng thời gian giữa các lần tải lên APT bằng cách lập trình thay vì sử dụng tệp cài đặt.

Các thay đổi về API

Thêm hàm: TuningFork_setAggregationStrategyInterval
Thêm trường vào cấu trúc TuningFork_Settings: aggregation_strategy_intervalms_or_count

Phiên bản Games-Activity 1.0.0

Phiên bản 1.0.0

Ngày 4 tháng 8 năm 2021

Phát hành androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 và androidx.games:games-text-input:1.0.0. Phiên bản 1.0.0 bao gồm các thay đổi sau.

Các tính năng chính của phiên bản 1.0.0

Đây là bản phát hành đầu tiên cho phiên bản ổn định của Games-Activity, Games-Controller và Games-Text-Input. Hãy xem Trang chủ AGDK để biết thêm thông tin.

Phiên bản 1.0.0-rc01

Ngày 12 tháng 7 năm 2021

Phát hành androidx.games:games-activity:1.0.0-rc01. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

Sửa loại dữ liệu trả về của GameActivityCallbacks::onSaveInstanceState

Phiên bản 1.0.0-beta01

Ngày 30 tháng 6 năm 2021

Phát hành androidx.games:games-activity:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Các thay đổi về API

Đổi tên GameActivityInputInfo thành GameActivityPointerAxes.
Lệnh gọi lại onNativeWindowResized hiện cung cấp chiều rộng và chiều cao của cửa sổ.
Xoá lệnh gọi lại onContentRectChanged.
Đã đổi tên onLowMemory thành onTrimMemory.
Xoá GameActivity_setWindowFormat.
Cải thiện mô hình quyền sở hữu đối với con trỏ GameActivityMotionEvents và GameActivityMotionEvent.
Cải thiện mô hình quyền sở hữu trạng thái người dùng trong lệnh gọi lại onSaveInstanceState.

Phiên bản 1.0.0-alpha01

Ngày 16 tháng 6 năm 2021

Phát hành androidx.games:games-activity:1.0.0-alpha01.

Tính năng mới

Games-Activity là thư viện mới thay cho NativeActivity như một phương thức khuyên dùng để tích hợp trò chơi C/C++ với Android.

Games-Controller Phiên bản 2.0

Phiên bản 2.0.0-alpha01

Ngày 11 tháng 1 năm 2023

Phát hành androidx.games:games-controller:2.0.0-alpha01. Phiên bản 2.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Phát hiện bàn phím phần cứng
Hỗ trợ báo cáo dữ liệu chuyển động của cảm biến tích hợp (tức là nhận dữ liệu về con quay hồi chuyển và gia tốc kế từ chính điện thoại)
Định dạng dữ liệu ánh xạ tay điều khiển mới được tối ưu hoá

Các thay đổi về API

Lệnh gọi API mới cho bàn phím phần cứng: Paddleboat_getPhysicalKeyboardStatus và Paddleboat_setPhysicalKeyboardStatusCallback
Các lệnh gọi API mới để báo cáo dữ liệu chuyển động của cảm biến tích hợp: Paddleboat_getIntegratedMotionSensorFlags và Paddleboat_setMotionDataCallbackWithIntegratedFlags
Lệnh gọi API mới cho định dạng dữ liệu ánh xạ tay điều khiển đã sửa đổi: Paddleboat_addControllerRemapDataFromFd, Paddleboat_addControllerRemapDataFromFileBuffer
Các lệnh gọi API ánh xạ cũ không dùng nữa: Paddleboat_addControllerRemapData và Paddleboat_getControllerRemapTableData

Sửa lỗi

Khắc phục sự cố về khả năng tương thích với các sự kiện chuyển động trong GameActivity 1.2.2 trở lên

Phiên bản Games-Controller 1.1.0

Phiên bản 1.1.0

Ngày 23 tháng 2 năm 2022

Phát hành androidx.games:games-activity:1.1.0 và androidx.games:games-controller:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.0.0

Games Activity (Hoạt động Trò chơi):

WindowInsets nghe và truy vấn để phản hồi vết khía (notch) và IME
Thêm bộ lọc khoá và sự kiện chuyển động
Sửa các lỗi:
- Bổ sung thông báo bị thiếu để tương thích với NativeActivity
- Sửa chữ ký của onNativeWindowResized
- Sửa lỗi mất sự kiện đầu vào

Phiên bản 1.1.0-rc01

Ngày 9 tháng 2 năm 2022

Phát hành androidx.games:games-controller:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.1.0-beta01

Ngày 26 tháng 1 năm 2022

androidx.games:games-controller:1.1.0-beta01 được phát hành mà không có thay đổi nào kể từ 1.1.0-alpha01. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.1.0-alpha01

Ngày 15 tháng 12 năm 2021

Phát hành androidx.games:games-controller:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Hỗ trợ thêm trạng thái pin, chế độ rung hai động cơ, điều khiển ánh sáng và báo cáo trục chuyển động trong các tay điều khiển được hỗ trợ khi chạy trên hệ điều hành Android S trở lên.

Các thay đổi về API

Thêm hàm Paddleboat_setMotionDataCallback để đăng ký các lệnh gọi lại dữ liệu chuyển động của tay điều khiển
Thêm chức năng Paddleboat_setControllerLight để thay đổi các tuỳ chọn cài đặt ánh sáng của tay điều khiển.
Thêm cấu trúc Paddleboat_Controller_Battery vào Paddleboat_Controller_Data
Cấu trúc mới:
- Paddleboat_Controller_Battery
- Paddleboat_Motion_Data
Enum mới:
- Paddleboat_BatteryStatus
- Paddleboat_LightType
- Paddleboat_Motion_Type
Cờ mới dành cho tay điều khiển:
- PADDLEBOAT_CONTROLLER_FLAG_ACCELEROMETER
- PADDLEBOAT_CONTROLLER_FLAG_GYROSCOPE
- PADDLEBOAT_CONTROLLER_FLAG_LIGHT_PLAYER
- PADDLEBOAT_CONTROLLER_FLAG_LIGHT_RGB
- PADDLEBOAT_CONTROLLER_FLAG_BATTERY

Sửa lỗi

Thêm mục nhập cơ sở dữ liệu mã thiết bị thay thế cho tay điều khiển PS4
Thêm mục nhập cơ sở dữ liệu >=31 cho tay điều khiển PS5

Phiên bản Games-Controller 1.0.0

Phiên bản 1.0.0

Ngày 4 tháng 8 năm 2021

Phát hành androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 và androidx.games:games-text-input:1.0.0. Phiên bản 1.0.0 bao gồm các thay đổi sau.

Các tính năng chính của phiên bản 1.0.0

Đây là bản phát hành đầu tiên cho phiên bản ổn định của Games-Activity, Games-Controller và Games-Text-Input. Hãy xem Trang chủ AGDK để biết thêm thông tin.

Phiên bản 1.0.0-rc02

Ngày 21 tháng 7 năm 2021

Phát hành androidx.games:games-controller:1.0.0-rc02. Phiên bản 1.0.0-rc02 bao gồm các thay đổi sau.

Sửa lỗi

Sửa lỗi đóng gói khiến quá trình nhập Prefab vào các phép hoán vị cấu trúc/phiên bản trống và chưa được sử dụng không thành công.

Phiên bản 1.0.0-rc01

Ngày 12 tháng 7 năm 2021

Phát hành androidx.games:games-controller:1.0.0-rc01. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

Sửa vấn đề không tương thích với phiên bản GameActivity mới nhất

Phiên bản 1.0.0-beta01

Ngày 30 tháng 6 năm 2021

Phát hành androidx.games:games-controller:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Các thay đổi về API

Các hàm trả về một giá trị boolean thành công hoặc thất bại hiện trả về một enum Paddleboat_Error_Code.
Đổi tên Paddleboat_onPause thành Paddleboat_onStop.
Đổi tên Paddleboat_onResume thành Paddleboat_onStart.
Paddleboat_ProcessGameActivityEvent tách thành hai hàm: Paddleboat_processGameActivityKeyInputEvent và Paddleboat_processGameActivityMotionInputEvent
Xoá các tính năng mở rộng của tay điều khiển buộc phải xây dựng dựa trên bản xem trước của SDK Android S
Thêm hàm Paddleboat_getBackButtonConsumed
Hiện tại, lệnh gọi lại trạng thái tay điều khiển và trạng thái chuột sẽ có tham số không bắt buộc của một con trỏ tới dữ liệu do người dùng xác định
Di chuyển chuỗi tên tay điều khiển ra khỏi cấu trúc thông tin thiết bị và hiện giờ truy cập qua hàm Paddleboat_getControllerName

Sửa lỗi

Khắc phục sự cố tay điều khiển lúc đầu không tự báo cáo là tay điều khiển nhưng sau đó báo cáo thông qua thông báo onInputDeviceChanged, do đó không được phát hiện chính xác ở dạng kết nối tay điều khiển.

Phiên bản 1.0.0-alpha01

Ngày 16 tháng 6 năm 2021

Phát hành androidx.games:games-controller:1.0.0-alpha01.

Tính năng mới

Games-Controller là một thư viện mới cung cấp C API để phát hiện, đọc dữ liệu đầu vào và tương tác với các thiết bị tay điều khiển trò chơi.

Games-Text-Input Phiên bản 1.1

Phiên bản 1.1.2-alpha01

Ngày 9 tháng 11 năm 2022

Phát hành androidx.games:games-text-input:1.1.2-alpha01. Phiên bản 1.1.2-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Không có thay đổi mới nào

Phiên bản 1.1.1

Ngày 13 tháng 7 năm 2022

Phát hành androidx.games:games-text-input:1.1.1. Phiên bản 1.1.1 bao gồm các thay đổi sau.

Sửa lỗi

Khắc phục các vấn đề liên quan đến việc thiếu tệp .aar trong bản phát hành trước.

Phiên bản 1.1.0

Ngày 9 tháng 2 năm 2022

Phát hành androidx.games:games-text-input:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau..

Những thay đổi quan trọng kể từ phiên bản 1.0.0 – Thêm chức năng nghe và truy vấn WindowInsets vào GameTextInput – Thêm tiêu đề gamecommon.h bị thiếu

Phiên bản 1.1.0-rc01

Ngày 26 tháng 1 năm 2022

Phát hành androidx.games:games-text-input:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.1.0-beta01

Ngày 15 tháng 12 năm 2021

Phát hành androidx.games:games-text-input:1.1.0-beta01. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Sửa lỗi

Sửa các phần lồng ghép thác nước và IME
Bổ sung tiêu đề gamegeneric.h bị thiếu

Phiên bản 1.1.0-alpha01

Ngày 13 tháng 10 năm 2021

Phát hành androidx.games:games-text-input:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Các thay đổi về API

Thêm chức năng phần lồng ghép IME vào GameTextInput

Games-Text-Input Phiên bản 1.0

Phiên bản 1.0.0

Ngày 4 tháng 8 năm 2021

Phát hành androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0 và androidx.games:games-text-input:1.0.0. Phiên bản 1.0.0 bao gồm các thay đổi sau.

Các tính năng chính của phiên bản 1.0.0

Đây là bản phát hành đầu tiên cho phiên bản ổn định của Games-Activity, Games-Controller và Games-Text-Input. Hãy xem Trang chủ AGDK để biết thêm thông tin.

Phiên bản 1.0.0-rc01

Ngày 12 tháng 7 năm 2021

Phát hành androidx.games:games-text-input:1.0.0-rc01 mà không có thay đổi nào. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.0.0-beta01

Ngày 30 tháng 6 năm 2021

Phát hành androidx.games:games-text-input:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Các thay đổi về API

Cải thiện mô hình quyền sở hữu của các đối tượng GameTextInputState.
Đang xử lý các loại để thống nhất với NDK.

Phiên bản 1.0.0-alpha01

Ngày 16 tháng 6 năm 2021

Phát hành androidx.games:games-text-input:1.0.0-alpha01.

Tính năng mới

Games-Text-Input là thư viện mới giúp nhà phát triển trò chơi sử dụng tính năng nhập bằng bàn phím mềm Android trong C/C++.

Games Frame Pacing (Tốc độ khung hình trò chơi) Phiên bản 2.0

Phiên bản 2.0.0-beta01

Ngày 8 tháng 2 năm 2023

Phát hành androidx.games:games-frame-pacing:2.0.0-beta01. Phiên bản 2.0.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Giới thiệu API mới để xoá số liệu thống kê về khung.

Các thay đổi về API

Thêm các API SwappyGL_clearStats và SwappyGL_clearStats.

Phiên bản 2.0.0-alpha01

Ngày 11 tháng 1 năm 2023

Phát hành androidx.games:games-frame-pacing:2.0.0-alpha01. Phiên bản 2.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Bổ sung số liệu thống kê về khung vulkan

Các thay đổi về API

Số phiên bản lớn tăng thành 2.0.0 do quá trình tái cấu trúc tệp bản dựng
Thêm 3 API mới: SwappyVk_enableStats, SwappyVk_recordFrameStart và SwappyVk_getStats

Sửa lỗi

Chỉ áp dụng ngưỡng trong chế độ hoán đổi tự động (Ic0786)

Games Frame Pacing 1.10

Phiên bản 1.10.2-alpha01

Ngày 9 tháng 11 năm 2022

Phát hành androidx.games:games-frame-pacing:1.10.2-alpha01. Phiên bản 1.10.2-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Không có thay đổi mới nào

Phiên bản 1.10.1

Ngày 15 tháng 6 năm 2022

Phát hành androidx.games:games-frame-pacing:1.10.1. Phiên bản 1.10.1 bao gồm các thay đổi sau.

Sửa lỗi

Khắc phục lỗi hoán đổi nội dung không được tạo bằng ndk <23 và > 17.
Cấp quyền truy cập API để truy xuất tốc độ làm mới được màn hình hỗ trợ.

Phiên bản 1.10.0

Ngày 23 tháng 2 năm 2022

Phát hành androidx.games:games-frame-pacing:1.10.0. Phiên bản 1.10.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.9.0

Bỏ qua các đầu vào bộ lọc Choreographer bị nhiễu và tăng cường làm mượt nhằm tránh tình trạng treo trình mô phỏng.
Thêm hàm *_uninjectTracer.

Phiên bản 1.10.0-rc01

Ngày 9 tháng 2 năm 2022

Phát hành androidx.games:games-frame-pacing:1.10.0-rc01. Phiên bản 1.10.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.10.0-beta01

Ngày 26 tháng 1 năm 2022

Phát hành androidx.games:games-frame-pacing:1.10.0-beta01. Phiên bản 1.10.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.10.0-alpha01

Ngày 15 tháng 12 năm 2021

Phát hành androidx.games:games-frame-pacing:1.10.0-alpha01. Phiên bản 1.10.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Bổ sung hàm SwappyGL_uninjectTracer.

Các thay đổi về API

Xoá các lệnh gọi lại đã thêm trước đó bằng SwappyGL_injectTracer thông qua API SwappyGL_uninjectTracer(const SwappyTracer *t).

Games Frame Pacing (Tốc độ khung hình trò chơi) 1.9

Phiên bản 1.9.1

Ngày 13 tháng 10 năm 2021

Phát hành androidx.games:games-frame-pacing:1.9.1. Phiên bản 1.9.1 bao gồm các thay đổi sau.

Sửa lỗi

Sửa lỗi b/199487756

Phiên bản 1.9.0

Ngày 12 tháng 7 năm 2021

Phát hành androidx.games:games-frame-pacing:1.9.0. Phiên bản 1.9.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.7.0

Cập nhật để phù hợp với giao thức tạo phiên bản nội bộ.

Games Frame Pacing (Tốc độ khung hình trò chơi) 1.7.0

Phiên bản 1.7.0

Ngày 30 tháng 6 năm 2021

Phát hành androidx.games:games-frame-pacing:1.7.0. Phiên bản 1.7.0 chứa những thay đổi đã được xác nhận này.

Phiên bản 1.7.0-rc01

Ngày 2 tháng 6 năm 2021

Phát hành androidx.games:games-frame-pacing:1.7.0-rc01. Phiên bản 1.7.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.7.0-beta02

Ngày 24 tháng 2 năm 2021

Phát hành androidx.games:games-frame-pacing:1.7.0-beta02.

Phiên bản 1.7.0-beta01

Ngày 16 tháng 12 năm 2020

Phát hành androidx.games:games-frame-pacing:1.7.0-beta01.

Games Performance Tuner (Trình theo dõi hiệu suất trò chơi) 1.4.3

Phiên bản 1.4.3

Ngày 12 tháng 7 năm 2021

Phát hành androidx.games:games-performance-tuner:1.4.3. Phiên bản 1.4.3 bao gồm các thay đổi sau.

Thay đổi quan trọng kể từ phiên bản 1.1.0

Cập nhật để phù hợp với giao thức tạo phiên bản nội bộ.

Games Performance Tuner (Trình theo dõi hiệu suất trò chơi) 1.1.0

Phiên bản 1.1.0

Ngày 30 tháng 6 năm 2021

Phát hành androidx.games:games-performance-tuner:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau.

Phiên bản 1.1.0-rc01

Ngày 2 tháng 6 năm 2021

Phát hành androidx.games:games-performance-tuner:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.1.0-beta03

Ngày 21 tháng 4 năm 2021

Phát hành androidx.games:games-performance-tuner:1.1.0-beta03.

Phiên bản 1.1.0-beta02

Ngày 24 tháng 2 năm 2021

Phát hành androidx.games:games-performance-tuner:1.1.0-beta02.

Phiên bản 1.1.0-beta01

Ngày 16 tháng 12 năm 2020

Phát hành androidx.games:games-performance-tuner:1.1.0-beta01.

Phiên bản 1.1.0-alpha01

Phát hành androidx.games:games-performance-tuner:1.1.0-alpha01.

Phiên bản 1.0.0

Phiên bản 1.0.0-alpha02

Ngày 12 tháng 8 năm 2020

Đổi tên thư viện Android Gaming thành thư viện Android Games.

androidx.gaming -> androidx.games

Phiên bản 1.0.0-alpha01

Ngày 10 tháng 6 năm 2020

Phát hành androidx.games:1.0.0-alpha01.