RshMod 기기 스푸핑 API 문서

개요

RshMod는 Android ContentProvider로 기기 스푸핑 API를 제공합니다. 스크립트와 adb는 아래 URI 및 rsh.action.* / rsh.extra.* 이름만 사용하면 됩니다.

공개 API 사양

사전 준비

1. RshMod APK(v6.68) 설치, LSPosed에서 대상 앱 범위 활성화
2. Root 기기(Magisk), RshMod에 root 권한 허용
3. RshMod 앱 실행 후 로그인(로컬 세션 24시간)
4. 메인 화면에서 모듈·root 준비 완료(청록색 상태 권장)
5. 스크립트 호출 전 최소 1회 로그인 성공 확인

엔드포인트

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[...]

비공개: SETTINGS(개별 필드 수정), CLEAR_SETTINGS(초기화). 일괄 적용은 GENERATE_AND_APPLY 사용.

브랜드와 모델은 아래「브랜드 및 모델」에서 확인하거나 앱에서 선택하세요.

요청 extras

레거시 키(자동 매핑, rsh.extra.* 권장)

국가 / 브랜드 / 모델 조합

모델 매칭 우선순위

1. 표시명 정확 일치(예: Xiaomi 15)
2. 기기 코드 정확 일치(예: 24129PN74C)
3. 이름/코드 부분 일치(대소문자 무시, 첫 매칭)

브랜드는 내장 라이브러리와 정확히 일치(대소문자 구분). 잘못된 값은 랜덤으로 대체.

응답 필드(Bundle)

일반적인 응답

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

사용 예시

일반적인 호출 순서 예시입니다. adb는 PC(USB 디버깅)에서, JavaScript 자동화는 기기에서 ContentResolver로 실행합니다. 45개 항목은 국가+기기 프로필마다 랜덤 생성됩니다.

adb 명령

형식: adb shell content call --uri content://im.rsh.mod --method <METHOD> [--extra key:s:value …]. s=문자열. Random=랜덤. 먼저 앱 로그인.

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

JavaScript 자동화

Android context가 있는 자동화 환경에서 기기 실행. 공통 함수 후 시나리오, 줄마다 주석.

공통 함수(스크립트 상단에 붙여넣기)

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"); }

권장 자동화 흐름

1. RshMod 앱 로그인 확인(24시간 세션)
2. rsh.action.IS_READY 호출 — authorized·result true 확인
3. 필요에 따라 국가만/Random/고정 brand·model로 GENERATE_AND_APPLY 호출
4. rsh.extra.result == true 확인, country/brand/model 기록
5. 대상 앱 강제 종료 후 재시작(Hook 반영)

생성되는 45개 파라미터

GENERATE_PARAMS / GENERATE_AND_APPLY는 국가+기기 프로필마다 rsh.extra.params에 45개 연동 필드 생성.

GET_PARAMS count는 Hook 스위치 12개 포함 시 56.

문제 해결

지원 국가(50)

rsh.action.LIST_COUNTRIES로도 조회 가능.

내장 브랜드·모델(v6.68)

21브랜드·130모델 — 앱 선택 목록·DEVICE_DATABASE와 동일.

2025–2026 플래그십

rsh.extra.model 입력 형식

model 미지정: 국가 가중치로 브랜드 선택 후 소득 수준별 Android 버전.

버전 및 호환

사용 전 LSPosed에서 RshMod 활성화 및 대상 앱 범위 선택.