Game Mailbox
Là tính năng dùng để server gửi các mail cho người chơi ở trong game
Last updated
Là tính năng dùng để server gửi các mail cho người chơi ở trong game
Last updated
Chức năng Game Mailbox giúp làm được các việc sau:
Gửi các thông báo update, hoặc các thông tin sự kiện ... về cho người chơi trong game.
Gửi các phần thưởng cho người chơi, để người chơi nhận thưởng.
Gửi một link cho người chơi qua mail, và người chơi bấm vào link đó để xem thông tin, và có thể nhận một phần thưởng nào đó.
Người chơi đến một mốc nào đó trong game, và gửi kích hoạt lên server, để server gửi 1 mail thưởng cho người chơi.
Có thể sử dụng Plugin MailBox thay vì phải thực thi từng API,
Trong Plugin MailBox không áp dụng cho API:
Dùng để lấy số lượng các mail chưa đọc và hiển thị cho người chơi biết có bao nhiêu mail chưa đọc.
Các tham số
onComplete
: Hàm xử lý với param là số lượng các mail chưa đọc
errorCallback
: Hàm xử lý khi có lỗi xảy ra
Code mẫu:
Dùng để lấy số lượng các mail chưa đọc theo từng loại.
Ví dụ khi biết loại mail Reward có 3 mail chưa đọc, thì lúc này sẽ có tutorial bàn tay chỉ vào để khiến user mở ra, đọc mail và nhận thưởng, giúp tăng tương tác vào mailbox của user.
Các tham số
onComplete
: Hàm xử lý với param là thông tin số lượng các mail chưa đọc theo từng loại
errorCallback
: Hàm xử lý khi có lỗi xảy ra
Code mẫu:
Lấy danh sách các mail về và xử lý logic tùy theo loại mail
Server chỉ trả về tối đa 30 mail, nếu người chơi muốn nhận thêm, thì phải đọc và xóa các mail đã sử dụng.
Mỗi mail nếu chưa đọc và chưa nhận thưởng, hoặc chưa sử dụng thì sẽ chỉ tồn tại tối đa trong 30 ngày.
Nếu mail đã được sử dụng thì sẽ hiển thị trong vòng 3 ngày, sẽ tự động bị xóa.
Các tham số
onComplete
: Hàm xử lý với param là danh sách các mail
lang
: Mã ngôn ngữ tiêu chuẩn theo từng quốc gia, và là mã ngôn ngữ mà người chơi đang sử dụng trong game.
errorCallback
: Hàm xử lý khi có lỗi xảy ra
Code mẫu:
Xử lý logic theo từng loại mail
Nếu type == Normal
thì hiển thị nội dung mail, và đánh đấu dọc mail đã đọc thì dùng GSMMailBox.ReadMail(mailId);
Dùng để khi mở mail ra đọc, thì đánh dấu lại.
Các tham số
mailId
: Id của mail muốn đánh dấu đọc.
onSuccess
: Hàm xử lý khi đánh dấu đọc mail thành công.
errorCallback
: Hàm xử lý khi có lỗi xảy ra, và param là lý do, hoặc lỗi
Code mẫu:
Dùng để khi mail đã claim phần thưởng, hoặc đã openlink thì đánh dấu mail đã được sử dụng.
Mục đích để server sẽ không cho phép claim cho lần sau.
Các mail đã sử dụng thì sau 3 ngày sẽ tự động bị xóa.
Các tham số
mailId
: Id của mail muốn đánh dấu sử dụng.
onSuccess
: Hàm xử lý khi đánh dấu sử dụng mail thành công.
errorCallback
: Hàm xử lý khi có lỗi xảy ra, và param là lý do, hoặc lỗi.
Code mẫu:
Dùng để khi mail là loại ô nhập, thì gửi giá trị ô nhập lên server xử lý.
Mail sẽ được đánh dấu là đã sử dụng khi submit thành công.
Các mail đã sử dụng thì sau 3 ngày sẽ tự động bị xóa.
Khi gửi thành công thì nếu mail có reward thì trả reward cho user.
Các tham số
mailId
: Id của mail đang chọn.
inputValue
: Giá trị của ô nhập
onSuccess
: Hàm xử lý khi submit giá trị inputValue thành công.
errorCallback
: Hàm xử lý khi có lỗi xảy ra, và param là lý do, hoặc lỗi.
Code mẫu:
Tình huống kịch bản game muốn, khi user đến một level (ví dụ là: level7
), hay 1 điểm nào đó thì sẽ nhận được mail có phần thưởng.
Các tham số
triggerPoint
: Điểm kích hoạt mail.
onSuccess
: Hàm xử lý khi kích hoạt mail thành công.
errorCallback
: Hàm xử lý khi có lỗi xảy ra.
Code mẫu:
Chỉ nên xóa các mail đã đọc, và đã used
Các tham số
mailIds
: Danh sách id của các mail muốn xóa.
onSuccess
: Hàm xử lý khi xóa mail thành công.
errorCallback
: Hàm xử lý khi có lỗi xảy ra.
Code mẫu:
Nếu type == Reward
thì hiển thị nội dung mail, và thì dùng GSMMailBox.ReadMail(mailId);
. Sau đó xử lý phần thưởng trả cho user từ trường reward
và dùng GSMMailBox.UseMail(mailId);
Nếu type == Openlink
thì hiển thị nội dung mail, và thì dùng GSMMailBox.ReadMail(mailId);
. Sau đó xử lý redirect sang link từ trường link
và dùng GSMMailBox.UseMail(mailId);
Nếu type == Input
thì sẽ hiển thị 1 ô nhập, và có nút submit, khi nhấn nút submit thì sẽ gửi giá trị nhập lên server theo api ở mục