Tài liệu API giả lập thiết bị RshMod

Tổng quan

RshMod cung cấp API giả lập thiết bị qua Android ContentProvider. Script và adb chỉ cần URI và tên rsh.action.* / rsh.extra.* bên dưới.

Quy cách API công khai

Điều kiện trước khi dùng

1. Cài RshMod APK (v6.68), bật module trong LSPosed và chọn phạm vi app
2. Máy đã root (Magisk), cấp quyền root cho RshMod
3. Mở app RshMod và đăng nhập (phiên 24 giờ)
4. Màn hình chính hiển thị module và root sẵn sàng (trạng thái xanh lam)
5. Đảm bảo đăng nhập thành công ít nhất một lần trước khi gọi API

Điểm cuối API

Cú pháp gọi adb:

adb shell content call --uri content://im.rsh.mod \
  --method <METHOD> \
  --extra <KEY>:<TYPE>:<VALUE>

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.IS_READY

rsh.extra.result=true
rsh.extra.authorized=true

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.LIST_COUNTRIES

rsh.extra.countries=[US, CN, JP, ...]

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_PARAMS \
  --extra rsh.extra.country:s:CN \
  --extra rsh.extra.brand:s:Random

rsh.extra.result=true
rsh.extra.count=45
rsh.extra.params=Bundle[...]

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_AND_APPLY \
  --extra rsh.extra.country:s:US \
  --extra rsh.extra.brand:s:Samsung \
  --extra rsh.extra.model:s:Random

rsh.extra.result=true
rsh.extra.count=45
rsh.extra.country=US

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GET_PARAMS

rsh.extra.count=56
rsh.extra.params=Bundle[...]

Không công khai: SETTINGS (sửa từng trường), CLEAR_SETTINGS (xóa). Dùng GENERATE_AND_APPLY cho hàng loạt.

Xem mục Hãng và mẫu bên dưới, hoặc chọn trong ứng dụng.

Extras yêu cầu

Khóa cũ (tự ánh xạ; nên dùng rsh.extra.*)

Tổ hợp quốc gia / hãng / mẫu

Thứ tự khớp mẫu

1. Khớp chính xác tên hiển thị (VD Xiaomi 15)
2. Khớp chính xác mã thiết bị (VD 24129PN74C)
3. Khớp chuỗi con tên/mã (không phân biệt hoa thường)

Hãng phải khớp thư viện (phân biệt hoa thường). Sai sẽ ngẫu nhiên hóa.

Trường phản hồi (Bundle)

Phản hồi thường gặp

rsh.extra.result=false
rsh.extra.authorized=false
rsh.extra.message=Unauthorized: login required

Ví dụ sử dụng

Ví dụ theo thứ tự gọi thông thường. adb trên PC (USB debug); JavaScript trên thiết bị qua ContentResolver. 45 trường sinh ngẫu nhiên theo quốc gia + hồ sơ thiết bị.

Lệnh adb

Cú pháp: adb shell content call --uri content://im.rsh.mod --method <METHOD> [--extra key:s:value …]. s=chuỗi. Random=ngẫu nhiên. Đăng nhập app trước.

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.IS_READY

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.LIST_COUNTRIES

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_AND_APPLY

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_AND_APPLY \
  --extra rsh.extra.country:s:CN

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_AND_APPLY \
  --extra rsh.extra.country:s:CN \
  --extra rsh.extra.brand:s:Random

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_AND_APPLY \
  --extra rsh.extra.country:s:US \
  --extra rsh.extra.brand:s:Samsung

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_AND_APPLY \
  --extra rsh.extra.country:s:JP \
  --extra rsh.extra.brand:s:Samsung \
  --extra rsh.extra.model:s:Random

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_AND_APPLY \
  --extra rsh.extra.country:s:CN \
  --extra rsh.extra.brand:s:Xiaomi \
  --extra rsh.extra.model:s:24129PN74C

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GENERATE_PARAMS \
  --extra rsh.extra.country:s:DE \
  --extra rsh.extra.brand:s:Random

adb shell content call --uri content://im.rsh.mod \
  --method rsh.action.GET_PARAMS

Tự động hóa JavaScript

Chạy trên thiết bị trong môi trường tự động hóa có Android context. Hàm chung trước, rồi kịch bản — có chú thích từng dòng.

Hàm dùng chung (dán đầu script)

const RSH_URI = "content://im.rsh.mod";
const EXTRA_RESULT = "rsh.extra.result";
const EXTRA_AUTHORIZED = "rsh.extra.authorized";
const EXTRA_COUNTRY = "rsh.extra.country";
const EXTRA_BRAND = "rsh.extra.brand";
const EXTRA_MODEL = "rsh.extra.model";
const EXTRA_COUNT = "rsh.extra.count";
const EXTRA_MESSAGE = "rsh.extra.message";

function isReady() {
    let cr = context.getContentResolver();
    let bundle = cr.call(android.net.Uri.parse(RSH_URI), "rsh.action.IS_READY", null, null);
    if (bundle == null) return false;
    if (!bundle.getBoolean(EXTRA_AUTHORIZED, false)) return false;
    return bundle.getBoolean(EXTRA_RESULT, false);
}

function generateAndApply(country, brand, model) {
    let cr = context.getContentResolver();
    let uri = android.net.Uri.parse(RSH_URI);
    let extras = new android.os.Bundle();
    if (country) extras.putString(EXTRA_COUNTRY, country.toUpperCase());
    if (brand) extras.putString(EXTRA_BRAND, brand);
    if (model) extras.putString(EXTRA_MODEL, model);
    return cr.call(uri, "rsh.action.GENERATE_AND_APPLY", null, extras);
}

function logApplyResult(res, label) {
    if (res == null) { loge(label + ": no response"); return; }
    if (res.getBoolean(EXTRA_RESULT, false)) {
        logd(label + " OK country=" + res.getString(EXTRA_COUNTRY, "")
            + " brand=" + res.getString(EXTRA_BRAND, "")
            + " model=" + res.getString(EXTRA_MODEL, "")
            + " count=" + res.getInt(EXTRA_COUNT, 0));
    } else {
        loge(label + " failed: " + res.getString(EXTRA_MESSAGE, ""));
    }
}

if (!isReady()) { loge("not ready"); } else {
    let cr = context.getContentResolver();
    let res = cr.call(android.net.Uri.parse(RSH_URI), "rsh.action.GENERATE_AND_APPLY", null, new android.os.Bundle());
    logApplyResult(res, "full random");
}

if (isReady()) { logApplyResult(generateAndApply("CN", null, null), "CN only"); }

if (isReady()) { logApplyResult(generateAndApply("CN", "Random", null), "CN+Random"); }

if (isReady()) { logApplyResult(generateAndApply("US", "Samsung", null), "US+Samsung"); }

if (isReady()) { logApplyResult(generateAndApply("JP", "Samsung", "Random"), "JP+Random model"); }

if (isReady()) { logApplyResult(generateAndApply("CN", "Xiaomi", "24129PN74C"), "exact"); }

Luồng tự động hóa đề xuất

1. Đảm bảo đã đăng nhập RshMod (phiên 24h)
2. Gọi rsh.action.IS_READY — authorized và result phải true
3. Gọi GENERATE_AND_APPLY với quốc gia/Random/hãng/mẫu cố định tùy nhu cầu
4. Kiểm tra rsh.extra.result == true; ghi country/brand/model trả về
5. Buộc dừng app đích và mở lại để Hook nhận hồ sơ mới

45 tham số được sinh

GENERATE_PARAMS / GENERATE_AND_APPLY sinh 45 trường liên kết trong rsh.extra.params theo quốc gia + hồ sơ thiết bị.

GET_PARAMS count có thể 56 kèm 12 công tắc Hook.

Khắc phục sự cố

Quốc gia hỗ trợ (50)

Cũng lấy qua rsh.action.LIST_COUNTRIES.

Hãng và mẫu tích hợp (v6.68)

21 hãng, 130 mẫu — khớp danh sách trong app và DEVICE_DATABASE.

Flagship 2025–2026

Giá trị rsh.extra.model

Không có model: chọn hãng theo trọng số quốc gia, rồi phiên bản Android theo thu nhập.

Phiên bản và tương thích

Bật RshMod trong LSPosed và chọn phạm vi app trước khi dùng.