Lối tắt trên màn hình nền

Sử dụng hộp thoại gốc, bạn có thể cung cấp cho người dùng thêm liên kết lối tắt vào màn hình nền dẫn đến trò chơi của bạn.

Trước khi hiển thị hộp thoại, hãy đảm bảo rằng tùy chọn này có thể dùng được.

Kiểm tra xem việc thêm lối tắt có dùng được hay không

Tùy chọn có dùng được hay không tùy thuộc vào nền tảng, quy tắc trình duyệt nội bộ và các hạn chế của Yandex Games. Để xác minh rằng có thể thêm lối tắt, hãy sử dụng phương thức ysdk.shortcut.can_show_prompt():

ysdk.shortcut.can_show_prompt(function (self, can_show)
  if can_show then
    -- Tại đây bạn có thể hiển thị nút để thêm lối tắt.
  end
end)

Mở hộp thoại

Sau khi kiểm tra, bạn có thể hiển thị một nút (hoặc một phần tử giao diện người dùng khác) trong trò chơi và khiến cho nút này gọi một hộp thoại để thêm lối tắt khi người dùng nhấp vào nút. Để gọi hộp thoại, hãy sử dụng phương thức ysdk.shortcut.show_prompt():

ysdk.shortcut.show_prompt(function (self, accepted)
  if accepted then
    -- Tại đây bạn có thể cấp phần thưởng cho việc thêm lối tắt.
  end
end)

Lần đầu tiên gọi phương thức này, một lối tắt được tạo cho danh mục Yandex Games. Nếu đã tồn tại, một lối tắt có liên kết đến trò chơi sẽ được tạo.