1. Cấu hình và cài đặt
Last updated
Last updated
Unity version ≥ 2020.x.x
Language version ≥ C# 6.0
Chúng tôi kiến nghị nâng cấp lên FalconCore và Falcon Analytic 3.0.0 do phiên bản 2.x.x đã bị deprecate và sẽ bị loại bỏ vào ngày 15/04/2024 ( những game chưa kịp cập nhật sẽ chỉ không có dữ liệu phân tích trên data4game, các tính năng khác chạy bình thường).
Để cài đặt Sdk phiên bản 3.0.x, nếu bạn đang cài đặt các phiên bản SDK 2.x.x hoặc cũ hơn, bạn cần gỡ cài đặt toàn bộ SDK cũ và cài lại để đảm bảo không bị lỗi trong quá trình cài đặt. Để tiện cho việc tái cài đặt, xin hãy thực hiện theo các bước sau:
Gỡ cài đặt toàn bộ SDK cũ bằng cách xóa toàn bộ phần code trong thư mục FalconCore
Tải và import FalconCore qua link ở bước 2
Nếu code bạn có đang cài đặt Analytic, tải và cài đặt gói FalconAnalytic qua link : https://bitbucket.org/falcongame/falcon-unity-sdk/raw/53fa3e75532403ece5c33ac4b97dd0289efead77/Assets/Falcon/Release/FalconAnalytics/FalconAnalytics-3.1.7.unitypackage
Fix toàn bộ lỗi trong code(có thể do việc SDK bản cũ có các hàm deprecate, đã bị loại bỏ). Lúc này Unity Editor sẽ reload và việc tái cài đặt sẽ thành công.
Tải gói FalconCore unitypackage bản mới nhất tại link bitbucket của chúng tôi tại https://bitbucket.org/falcongame/falcon-unity-sdk/raw/53fa3e75532403ece5c33ac4b97dd0289efead77/Assets/Falcon/Release/FalconCore/FalconCore-3.1.1.unitypackage
Import package FalconCore vào unity project, chuyển package tới thư mục mong muốn.
Lưu ý: Trong gói Core không bao hàm package JsonDotNet. Nếu bạn muốn tải, xin vui lòng tải tại đây. Gói được đặt tại vị trí FalconCore/ThirdParty/JsonDotNet
Liên hệ với chúng tôi qua data4game.com để nhận fKey, có thể xem hướng dẫn tại Hướng dẫn lấy FalconKey(FKey)
Nhập fKey vào Falcon/FalconMenu trên thanh công cụ.
Bấm Login (fKey sẽ được lưu lại và việc login sẽ được thực hiện tự động vào những lần kế tiếp, bạn chỉ phải thực hiện nhập fKey đăng nhập lại khi cập nhật FalconCore).
Sau khi Login xong, Menu sẽ hiện ra danh sách các API.
Bấm Install để cài đặt Plugin mong muốn(chúng tôi khuyến cáo chỉ nên tải và sử dụng những Plugin chính thức và có documents hướng dẫn chi tiết), bấm nút nhỏ màu đỏ bên cạnh để gỡ cài đặt Plugin. Sau khi cập nhật phiên bản mới, có thể phiên bản cũ của một số Plugin sẽ không còn tương thích và khi này cần cập nhật lại phiên bản mới của Plugin đó.
Hướng dẫn cài đặt chi tiết hơn (nếu có) sẽ được mô tả tại trang của từng API.
Notes: Có thể tham khảo một số lỗi thường gặp tại III.QnA
Log của SDK được mặc định tắt để tránh log những thông tin không cần thiết, ảnh hưởng tới quá trình dev phát triển game. Chỉ một số log error được hiển thị để cánh báo người dùng (không throw exception) khi phát hiện xung đột logic so với thông thường.
Để thực hiện việc hiện log debug trên app, xin hãy thực hiện các bước sau đây:
Truy cập File -> Build Settings...
Vào Player Settings...
Chọn platform tương ứng, sau đó tìm Other Settings -> Scripting Define Symbols, sau đó thêm FALCON_LOG_DEBUG.
