동적 구성 및 동적 업로드 주소 업데이트¶
이 문서에서는 UniApp SDK 0.3.0 이상 버전의 원격 구성을 능동적으로 업데이트하고 업로드 주소를 동적으로 변경하는 기능을 설명합니다.
동적 구성¶
원격 구성 능동 업데이트¶
uni-app 애플리케이션에서 이 기능을 호출하려면 먼저 sdkConfig에서 remoteConfiguration: true를 설정해야 합니다. 호스트 앱 내의 uni 미니 프로그램은 호스트 앱이 Native SDK를 초기화할 때 원격 구성을 활성화합니다. miniUpdateInterval은 이번 호출에서 지정된 최소 업데이트 간격을 사용합니다.
mobileAgent.updateRemoteConfigWithMiniUpdateInterval({
miniUpdateInterval: 0
}, result => {
if (result.success) {
console.log('remote config: ' + result.rawJson);
} else {
console.log('remote config failed: ' + result.errorMessage);
}
});
API - updateRemoteConfigWithMiniUpdateInterval¶
| 요청 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| miniUpdateInterval | number | 아니요 | 이번 능동 업데이트의 최소 간격, 범위 [0,), 단위 초, 기본값 0 |
콜백 매개변수:
| 반환 필드 | 유형 | 설명 |
|---|---|---|
| success | boolean | 업데이트 성공 여부 |
| platform | string | 현재 플랫폼 |
| rawJson | string | 업데이트 성공 시 반환된 원본 원격 구성 JSON 문자열 |
| errorCode | number/string | 업데이트 실패 시 오류 코드 |
| errorMessage | string | 업데이트 실패 시 오류 메시지 |
동적 업로드 주소 업데이트¶
초기화 시 datakitUrl과 datawayUrl을 모두 생략할 수 있습니다. 유효한 업로드 주소가 설정되기 전에도 SDK는 초기화되어 데이터를 캐시할 수 있으며, 주소 설정 후 업로드를 시작합니다. setDatakitURL과 setDatawayURL은 둘 중 하나만 선택하여 사용하며, DataWay로 전환할 때는 반드시 clientToken을 함께 전달해야 합니다.
mobileAgent.setDatakitURL({
datakitUrl: 'http://10.0.0.1:9529'
});
// DataWay를 사용하는 경우 아래 메서드로 setDatakitURL을 대체합니다.
mobileAgent.setDatawayURL({
datawayUrl: 'https://open.dataway.url',
clientToken: 'client-token'
});
API - setDatakitURL¶
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| datakitUrl | string | 예 | 새로운 Datakit 업로드 주소 |
API - setDatawayURL¶
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| datawayUrl | string | 예 | 새로운 DataWay 업로드 주소 |
| clientToken | string | 예 | DataWay 주소와 일치하는 인증 토큰 |