Cài đặt của người chơi

Âm lượng, phím, toàn màn hình, ngôn ngữ: những thứ người chơi tự chỉnh và mong game nhớ.

#include <njin.h>
 
namespace {
njin::action_handle jump;
bool open_settings = true;
 
void startup(njin::context &ctx) {
  jump = njin::action_register(ctx, "jump");
  njin::action_bind_key(ctx, jump, njin::key_space);
  njin::action_bind_pad(ctx, jump, njin::pad_face_down);
  // Sau khi đăng ký hết action và nạp ngôn ngữ: phím người chơi đã đổi, âm
  // lượng, toàn màn hình, ngôn ngữ thay cho giá trị mặc định.
  njin::settings_load(ctx);
}
 
void settings_menu(njin::context &ctx) {
  if (!open_settings)
    return;
  njin::ui_begin(ctx, {.id = "settings", .title = "Cài đặt"});
 
  // Âm lượng từng kênh. Kênh master nhân vào tất cả.
  njin::f32 music = njin::audio_bus_volume(ctx, njin::bus_music);
  if (njin::ui_slider(ctx, "Nhạc", music, 0.0f, 1.0f, 0.1f, true))
    njin::audio_set_bus_volume(ctx, njin::bus_music, music);
 
  // Đổi phím: bấm vào dòng rồi bấm phím mới. Dòng thứ hai cho tay cầm.
  njin::ui_keybind(ctx, "Nhảy", jump);
  njin::ui_keybind(ctx, "Nhảy##pad", jump, true);
 
  // Không coi Esc là "đóng menu" khi đang chờ phím.
  if (njin::ui_button(ctx, "Xong") || (!njin::ui_keybind_listening(ctx) && njin::ui_back(ctx))) {
    njin::settings_save(ctx); // ghi vào thư mục lưu game của người dùng
    open_settings = false;
  }
  njin::ui_end(ctx);
}
 
// Rung tay cầm khi trúng đòn.
void on_hit(njin::context &ctx) { njin::pad_rumble(ctx, 0, 0.6f, 0.8f, 0.25f); }
 
// Chuyển nhạc mượt giữa hai bản, theo giờ thật nên chạy cả khi game pause.
void enter_boss(njin::context &ctx, njin::music_handle boss) { njin::music_crossfade(ctx, boss, 1.5f); }
 
void setup(njin::context &ctx) {
  njin::ecs_register(ctx, njin::phase_startup, startup);
  njin::ecs_register(ctx, njin::phase_post_render, settings_menu);
}
} // namespace
 
int main() {
  njin::context *ctx = njin::create({.title = "Settings", .width = 1280, .height = 720, .target_fps = 60});
  njin::mod_register(*ctx, {.name = "game", .setup = setup});
  (void)on_hit;
  (void)enter_boss;
  njin::run(*ctx);
  njin::destroy(ctx);
}

Kênh âm thanh

njin::audio_bus chia âm thanh thành kênh, như thanh trượt trong menu cài đặt. Âm lượng thật của một âm là âm lượng riêng của nó, nhân âm lượng kênh, nhân kênh bus_master.

Kênh	Dùng cho
bus_master	Nhân vào tất cả
bus_music	Mọi music
bus_sfx	Hiệu ứng trong game (mặc định của sound)
bus_ui	Tiếng menu; đưa vào bằng sound_set_bus()
bus_voice	Lồng tiếng

audio_set_bus_volume() và audio_set_bus_muted() có hiệu lực ngay, cả với âm đang phát. music_crossfade() chuyển nhạc mượt (theo giờ thật, nên chạy cả khi game pause); music_fade_in() và music_fade_out() cho từng bản.

Đổi phím

Một action có thể gắn phím, nút chuột và nút tay cầm. Để người chơi đổi:

• ui_keybind(): một dòng trong menu, "Nhảy | Space". Bấm vào rồi bấm phím mới (Esc hủy). Dùng ui_keybind(ctx, "Nhảy##pad", action, true) cho dòng nút tay cầm. Trong lúc chờ, UI không điều hướng; kiểm tra ui_keybind_listening() để không coi Esc là "đóng menu".
• action_rebind() là phép đổi phím ở dưới: nguồn mới thay nguồn cùng thiết bị của action, và bị gỡ khỏi mọi action khác để một phím không làm hai việc. Nhận phím bằng input_any_pressed().
• input_source_name() cho chữ hiện ("Space", "Left Shift", "Pad A"), và action_sources() liệt kê phím đang gắn: dùng để vẽ gợi ý "Bấm E để nói chuyện" đúng với phím người chơi đã đổi.

Lưu và nạp

njin::settings_load(ctx); // sau khi đăng ký hết action, axis và nạp ngôn ngữ
njin::settings_save(ctx); // khi rời menu cài đặt

File là JSON trong thư mục lưu game (settings.json, xem save_path()): âm lượng và tắt tiếng từng kênh, phím của mọi action và axis, toàn màn hình, ngôn ngữ. Phần nào không có trong file thì giữ nguyên, nên game thêm action mới trong bản cập nhật vẫn có phím mặc định. Dữ liệu riêng của game (độ khó, độ sáng) đi kèm dưới khóa game: settings_save(ctx, "settings.json", &data).

Nếu cần tự lưu phím vào chỗ khác: input_bindings_save() và input_bindings_load().

Rung tay cầm

pad_rumble() cho hai motor (trầm và nhanh) trong một khoảng thời gian; tay cầm không có motor thì không làm gì. Kết hợp với camera_shake() và hitstop() khi trúng đòn.