mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
820060e3a3
* chore: update deps
* style: update linter
* fix: fix catalog
* chore: tweaks navbar config
(cherry picked from commit 7ac010e072)
64 lines
2.9 KiB
Markdown
64 lines
2.9 KiB
Markdown
---
|
|
headerDepth: 0
|
|
category:
|
|
- FAQ
|
|
icon: iconfont icon-read
|
|
order: 8
|
|
comment: false
|
|
---
|
|
|
|
# Sistem Gacha dan Prinsip Expor
|
|
|
|
Sistem Gacha di Hutao mengalami redesain total dalam hal arsitektur dibandingkan dengan Snap Genshin.
|
|
|
|
Dokumen ini akan menjelaskan mekanisme catatan gacha dalam Genshin Impact dan prinsip teknis fungsi ekspor catatan gacha dalam Toolbox Hutao.
|
|
|
|
## Perolehan Catatan Gacha
|
|
|
|
Untuk mendapatkan catatan gacha, perlu dilakukan permintaan ke API milik miHoYo.
|
|
|
|
Berikut adalah beberapa poin penting mengenai API ini:
|
|
|
|
- Melalui API server miHoYo, kita hanya dapat mengakses catatan gacha dalam 6 bulan terakhir.
|
|
- Ini juga merupakan sumber catatan gacha di aplikasi Genshin Impact.
|
|
- API ini memiliki batasan kecepatan permintaan; permintaan terlalu cepat dapat menyebabkan kegagalan permintaan berikutnya dan kegagalan mendapatkan data dengan normal.
|
|
|
|
Untuk melakukan permintaan ke API ini, kita memerlukan empat parameter kunci.
|
|
|
|
- Saat ini, ada beberapa metode untuk mendapatkan parameter-parameter ini:
|
|
- Melalui log file Unity, mencari URL catatan gacha yang dibuka pengguna.
|
|
- Memantau lalu lintas lokal, menyaring URL catatan gacha.
|
|
- Mencari cache browser CefBrowser, menemukan URL catatan gacha.
|
|
- Dengan menggunakan Cookie yang berisi Stoken, memanggil API genAuthKey untuk mendapatkan parameter-parameter ini.
|
|
- Pengguna lanjutan dapat memasukkan URL terkait secara manual.
|
|
|
|
Setelah mendapatkan data dari API, kita mendapatkan catatan gacha yang tersebar, dan dengan menggabungkannya, kita bisa mendapatkan daftar catatan gacha lengkap.
|
|
|
|
## Penyimpanan Catatan Gacha
|
|
|
|
Setelah mendapatkan daftar catatan gacha lengkap, kita dapat menyederhanakannya dengan melakukan serialisasi ke dalam database lokal. Data ini dapat di-deserialisasi dari database saat diperlukan dan ditampilkan kepada pengguna.
|
|
|
|
Permintaan selanjutnya ke server hanya perlu membandingkan data di database dengan data baru yang diterima.
|
|
|
|
Dengan cara ini, pengguna dapat menyimpan catatan gacha akun mereka dalam jangka panjang.
|
|
|
|
## Format UIGF
|
|
|
|
> Uniformed Interchangeable GachaLog Format
|
|
|
|
UIGF adalah standar data pertukaran catatan gacha yang telah kami advokasi, luncurkan, dan **selalu kami pertahankan** bersama aplikasi catatan gacha lainnya.
|
|
|
|
Dengan format data yang terstandarisasi, pengguna dapat memindahkan catatan gacha mereka antar berbagai alat Genshin Impact untuk menggunakan fitur khusus masing-masing.
|
|
|
|
### Impor Catatan Gacha
|
|
|
|
Dengan menggunakan format data UIGF, pengguna dapat mengimpor data yang pernah disimpan dalam aplikasi lain.
|
|
|
|
Saat Hutao memproses impor, ia akan membandingkan indeks (ID) yang paling awal yang ada dalam penyimpanan lokal dan hanya mengimpor data yang lebih lama.
|
|
|
|
(Karena data asli yang lebih baru selalu dapat diambil dari server miHoYo, data semacam ini memiliki tingkat akurasi yang lebih tinggi.)
|
|
|
|
### Ekspor Catatan Gacha
|
|
|
|
~~Belum diimplementasikan, sedang dalam perancangan~~ Sudah diimplementasikan
|