Login SDK dành cho JavaScript
Giới thiệu
Login SDK dành cho JavaScript là bộ thư viện để các ứng dụng có thể tương tác với GG trên nền tảng web. Login SDK bao gồm các chức năng chính như sau:
- Đăng nhập bằng tài khoản GG, Facebook, Apple, Google, ZingID, Chơi ngay (Protected Guest), Role ID (REDIRECT)
- Nhúng vào ứng dụng website để thực hiện đăng nhập
- Hỗ trợ ứng dụng lấy thông tin tài khoản của người dùng
- Hỗ trợ 2 dạng tích hợp
- POPUP: Mở 1 cửa sổ mới để tiến hành đăng nhập
- REDIRECT: Mở 1 hộp thoại (dialog) trong trang web để chọn phương thức đăng nhập, sau đó di chuyển đến trang GG ID để tiến hành đăng nhập
- Tích hợp Server Side
🚨 POPUP sử dụng tốt nhất trên phiên bản Desktop, đối với các trình duyệt trong ứng dụng (webview in app) có thể xảy ra những lỗi không xử lý hết được
🚨 Login SDK khi sử dụng trình duyệt trong ứng dụng (webview in app) sẽ không thể đăng nhập bằng phương thức GOOGLE vì lí do bảo mật của GOOGLE, xem chi tiết
✅ Khuyến nghị sử dụng tích hợp REDIRECT
Tích hợp GG SDK
Tích hợp GG SDK, bạn cần làm theo các bước sau:
Bước 1: Đăng ký tài khoản và tạo ứng dụng: Để đăng ký ứng dụng, bạn vui lòng liên hệ qua email BaoNQ3 để lấy thông tin clientID và clientSecret.
Bước 2: Lựa chọn phương thức tích hợp: Hiện tại GG SDK cung cấp 2 giải pháp tích hợp sau
- Đăng nhập dạng POPUP
- Đăng nhập dạng REDIRECT
Bước 3: Tích hợp server side
Phương thức đăng nhập
GG SDK sử dụng phương thức đăng nhập mặc định bằng tài khoản GG (email hoặc số điện thoại), ngoài ra có thể đăng ký thêm các kênh đăng nhập khác với GG như:
| Phương thức đăng nhập | Chủ sở hữu |
|---|---|
| GG | GG ID - sử dụng email, số điện thoại |
| GG ID - chỉ sử dụng email | |
| PHONE_NUMBER | GG ID - chỉ sử dụng số điện thoại |
| ZING | Zing ID |
| APPLE | Apple |
| PROTECTED_GUEST | GG ID (Chơi ngay dành cho game cũ) |
| ROLE_ID | Integrated (Chỉ hỗ trợ cho REDIRECT) |
| GUEST | GG ID (Chơi ngay dành cho game mới) - sử dụng email + số điện thoại |
| GUEST_EMAIL | GG ID (Chơi ngay dành cho game mới) - chỉ sử dụng email |
| GUEST_PHONE_NUMBER | GG ID (Chơi ngay dành cho game mới) - chỉ sử dụng số điện thoại |
| GUEST_GAMES | GG ID - Sử dụng thông tin bảo vệ tài khoản trong game |
GUEST_GAMES
Tính năng đăng nhập Chơi ngay theo danh sách game
Khi chọn GUEST_GAMES, bạn cần cung cấp thông tin game theo định dạng sau
{
gamesInfo: [
{
clientId: "123321123123",
clientName: "Võ lâm truyền kỳ MAX",
clientLogoUrl: "https://cdn-gg.vnggames.app/logo/client_logo_jxm3.png",
},
{
clientId: "123321123124",
clientName: "Võ lâm truyền kỳ Mobile",
clientLogoUrl: "https://cdn-gg.vnggames.app/logo/client_logo_jxm.png",
},
{
clientId: "984745454866530308",
clientName: "2048",
clientLogoUrl:
"https://upload.wikimedia.org/wikipedia/commons/thumb/1/18/2048_logo.svg/220px-2048_logo.svg.png",
clientAuthMethod: "GUEST",
},
];
}
| Tên trường | Mô tả |
|---|---|
| clientId | Cung cấp bởi GG khi tạo client mới |
| clientName | Tên hiển thị |
| clientLogoUrl | Hình ảnh hiển thị (Chỉ chấp nhận các định dạng png, jpg, jpeg, png) |
| clientAuthMethod | Đăng nhập cho những game đã tích hợp GG SDK. (GUEST) |
🚨 Nếu truyền sai định dạng thì sẽ không hiển thị trên LoginHub
Cấu hình gamesConfig
| Tên trường | Mô tả | Giá trị mặc định |
|---|---|---|
| displayType | Chọn kiểu hiển thị games GRID: Hiển thị dạng lưới LIST: Hiển thị dạng danh sách | GRID |
| showSearch | Chức năng tìm kiếm game (Chỉ áp dụng cho displayType = LIST) | false |
✅ Khuyến nghị sử dụng tối đa 4 game với kiểu hiển thị GRID
Chức năng cung cấp
GG SDK cung cấp các chức năng sau:
| Chức năng | Phạm vi | Tham số | Mục đích |
|---|---|---|---|
| loginHub.init(config) | POPUP, REDIRECT, EMBED | - POPUP - Mở hộp thoại - Nhúng thẻ html | Khởi tạo cấu hình SDK |
| loginHub.doChangeLanguage(lang) | POPUP, REDIRECT | Ngôn ngữ | Thay đổi ngôn ngữ SDK |
| loginHub.showLoginHub() | REDIRECT, EMBED | Hiển thị login hub | |
| loginHub.hideLoginHub() | REDIRECT, EMBED | Ẩn login hub | |
| loginHub.loginMethods | POPUP, REDIRECT | Danh sách kênh đăng nhập hub | |
| loginHub.renderCustomMethodContent(method, cb) | REDIRECT, EMBED | - method: phuong thức đăng nhập - cb: callback sau khi khởi tạo thành công | Hiển thị nội dung sau khi chọn phương thức đăng nhập. Dành cho team muốn tự xây dựng giao diện sau khi chọn phương thức đăng nhập |
| loginHub.doRenderLoginHubGrid({ element, methods }) | REDIRECT, EMBED | - element: tag name element - methods: Danh sách phương thức đăng nhập | Hiển thị danh sách kênh đăng nhập dạng lưới |
| loginHub.doAuthentication({ element }) | POPUP, REDIRECT, EMBED | - element: tag name element | Hiển thị của sổ đăng nhập |
| loginHub.doToggleLoading(forceOff=false) | POPUP,REDIRECT, EMBED | forceOff: default false, nếu ko truyền, loginHub sẽ dựa vào trạng thái loading hiện tại để ẩn/hiện | Thay đổi trạng thái loading của loginHub |
Ngôn ngữ hỗ trợ
Tham khảo tài liệu ngôn ngữ
Phiên bản
1.3.1
Thêm ngôn ngữ mới zh-Hant (Tiếng trung phồn thể)
Thay đổi ngôn ngữ zh-CN thành zh-Hans (Tiếng trung giản thể)
Cập nhật hàm
loginHub.initThêm cấu hình ngôn ngữ
langCập nhật hàm
loginHub.doAuthenticationBỏ tham sốlang- Ngôn ngữ sử dụng khi khởi tạo SDK thay vì phải truyền vào hàm.
Theo dõi cập nhật qua từng phiên bản tại đây.
Thông tin môi trường
Hiện tại GG SDK đang hỗ trợ trên các môi trường sau:
| Môi trường | Đường dẫn SDK |
|---|---|
| Staging | LoginHub-1.3.1 |
| Production | LoginHub-1.3.1 |
Demo
Tham khảo ứng dụng demo
Hỗ trợ
Nếu có thắc mắc trong quá trình tích hợp, bạn có thể liên hệ trực tiếp qua email BaoNQ3 để được trợ giúp.
Thông tin và bài viết liên quan
- Tài liệu tích hợp server side sử dụng ECN Java SDK
- Tài liệu GG SDK dành cho JavaScript - Đăng nhập dạng POPUP
- Tài liệu GG SDK dành cho JavaScript - Đăng nhập dạng REDIRECT
- Tài liệu GG SDK dành cho JavaScript - Đăng nhập dạng REDIRECT - EMBED