ID Verification iOS SDK は、setCustomUI インターフェースを提供し、UI の色とアイコンをカスタマイズできます。ファイルとして、または JSON データ形式で構成をこのインターフェースに渡すことで、カスタム UI を適用できます。このトピックでは、UI カスタマイズインターフェースについて説明し、関連するコード例を提供します。
一部のカスタム構成では、SDK のアップグレードが必要になる場合があります。ご利用の前に、SDK を最新バージョンにアップグレードすることを推奨します。ユーザーインターフェースのカスタム設定と認証インターフェースの拡張パラメーターとの間に競合がある場合、ユーザーインターフェースのカスタム設定が優先されます。これにより、一貫性のある直感的なユーザーエクスペリエンスが保証されます。
インターフェースの説明
インターフェースの定義
iOS SDK は、setCustomUI インターフェースを提供し、UI の色とアイコンをカスタマイズできます。このメソッドを呼び出し、対応するパラメーターを渡すことで、UI をカスタマイズできます。
/**
* // カスタム UI の色とアイコンを設定します
*
* // カスタム UI を設定します
* @param configuration - 入力 JSON 文字列
* @param completeBlock - 構成結果のコールバック
*/
- (void)setCustomUI:(nonnull NSString *)configuration
complete:(void(^_Nullable)(BOOL success, NSError * _Nullable error))completeBlock;リクエストパラメーター
名前 | タイプ | 説明 |
configuration | NSString | カスタム UI 構成を JSON 文字列として指定します。 |
completeBlock | block | 結果コールバック。
|
サンプルコード
NSString *jsonString = @"{\"faceConfig\":{\"exitIconBase64\":\"data:image/png;base64,iVBORw0..\"}}";
[[AliyunIdentityPlatform sharedInstance] setCustomUI:@"" complete:^(BOOL success, NSError * _Nullable error) {
NSLog(@"%@",error.localizedDescription);
}];
カスタム UI 構成コンテンツ
完全な構成例
{
"faceConfig": {
"exitIconBase64": "exit_icon_base64",
"faceBGColor": "#FFFFFF",
"faceTitleColor": "#000000",
"faceTipColor": "#000000",
"opFailedTitleColor": "#000000",
"opFailedTipColor": "#000000",
"opFailedConfirmColor": "#4FA3EC",
"faceProgressEndColor": "#E3824C",
"exitAlertTitleColor": "#000000",
"exitAlertMessageColor": "#000000",
"exitAlertCancelColor": "#4FA3EC",
"exitAlertConfirmationColor": "#4FA3EC",
"timeoutAlertTitleColor": "#000000",
"timeoutAlertMessageColor": "#000000",
"timeoutAlertConfirmationColor": "#4FA3EC",
"tooManyRetriesAlertTitleColor": "#000000",
"tooManyRetriesAlertMessageColor": "#000000",
"tooManyRetriesAlertConfirmColor": "#4FA3EC",
"interruptedAlertTitleColor": "#000000",
"interruptedAlertMessageColor": "#000000",
"interruptedAlertConfirmColor": "#4FA3EC",
"permissionFailedAlertTitleColor": "#000000",
"permissionFailedAlertMessageColor": "#000000",
"permissionFailedAlertConfirmColor": "#4FA3EC",
"verifyNetworkErrorAlertTitleColor": "#000000",
"verifyNetworkErrorAlertMessageColor": "#000000",
"verifyNetworkErrorAlertConfirmColor": "#4FA3EC",
"verifyNetworkErrorAlertCancelColor": "#4FA3EC",
"verifyLoadingColor": "#585858"
},
"ocrConfig": {
"exitIconBase64": "exit_icon_base64",
"albumBase64": "album_base64",
"takePhotoBase64": "take_photo_base64",
"submitBase64": "submit_base64",
"ocrResultExitIconBase64": "ocr_result_exit_icon_base64",
"ocrResultTipIconBase64": "ocr_result_tip_icon_base64",
"ocrTitleColor": "#FFFFFF",
"ocrBorderColor": "#E3824C",
"ocrSubmitTitleColor": "#FFFFFF",
"ocrLoadingColor": "#FFFFFF",
"failedAlertTitleColor": "#000000",
"failedAlertMessageColor": "#000000",
"failedAlertCancelColor": "#4FA3EC",
"failedAlertConfirmationColor": "#4FA3EC",
"timeoutAlertTitleColor": "#000000",
"timeoutAlertMessageColor": "#000000",
"timeoutAlertConfirmationColor": "#4FA3EC",
"exitAlertTitleColor": "#000000",
"exitAlertCancelColor": "#4FA3EC",
"exitAlertConfirmationColor": "#4FA3EC",
"ocrResultTitleColor": "#000000",
"ocrResultTipBGColor": "#DFDFDF",
"ocrResultTipColor": "#000000",
"ocrResultInfoTitleColor": "#000000",
"ocrResultInfoContentColor": "#F6F6F6",
"ocrResultInfoBorderColor": "#E3824C",
"ocrResultTipTitleColor": "#D59F9E",
"ocrResultErrorTipBGColor": "#F6DAD5",
"ocrResultConfirmBtnDisabledBGColor": "#DADADA",
"ocrResultConfirmBtnDisabledTitleColor": "#FFFFFF",
"ocrResultConfirmBtnEnabledBGColor": "",
"ocrResultConfirmBtnEnabledTitleColor": "#FFFFFF",
"ocrResultExitAlertTitleColor": "#000000",
"ocrResultExitAlertCancelColor": "#000000",
"ocrResultExitAlertConfirmationColor": "#4FA3EC",
"restrictionsAlertTitleColor": "#000000",
"restrictionsAlertMessageColor": "#000000",
"restrictionsAlertConfirmationColor": "#4FA3EC",
"permissionFailedAlertTitleColor": "#000000",
"permissionFailedAlertMessageColor": "#000000",
"permissionFailedAlertConfirmColor": "#4FA3EC",
"ocrNetworkErrorAlertTitleColor": "#000000",
"ocrNetworkErrorAlertMessageColor": "#000000",
"ocrNetworkErrorAlertCancelColor": "#4FA3EC",
"ocrNetworkErrorAlertConfirmColor": "#4FA3EC",
"docErrorAlertTitleColor": "#000000",
"docErrorAlertMessageColor": "#000000",
"docErrorAlertCancelColor": "#4FA3EC",
"docErrorAlertConfirmColor": "#4FA3EC",
"ocrResultNetworkErrorAlertTitleColor": "#000000",
"ocrResultNetworkErrorAlertMessageColor": "#000000",
"ocrResultNetworkErrorAlertConfirmColor": "#4FA3EC",
"ocrResultInfoErrorAlertMessageColor": "#000000",
"ocrResultInfoErrorAlertConfirmColor": "#4FA3EC",
"ocrResultLoadingColor": "#FFFFFF",
"ocrGuideStartBtnDisableBGColor":"#d5d5d5",
"ocrGuideStartBtnDisableTextColor":"#F9F9FA"
}
}フィールド構成の効果
faceModule
faceBGColor
| exitIconBase64
| faceTitleColor
|
faceTipColor
| interruptedAlertTitleColor
| interruptedAlertMessageColor
|
interruptedAlertConfirmColor
| permissionFailedAlertTitleColor
| permissionFailedAlertMessageColor
|
permissionFailedAlertConfirmColor
| tooManyRetriesAlertTitleColor
| tooManyRetriesAlertMessageColor
|
tooManyRetriesAlertConfirmColor
| faceProgressEndColor
| exitAlertTitleColor
|
exitAlertMessageColor
| exitAlertCancelColor
| exitAlertConfirmationColor
|
timeoutAlertTitleColor
| timeoutAlertMessageColor
| timeoutAlertConfirmationColor
|
verifyLoadingColor
| verifyNetworkErrorAlertTitleColor
| verifyNetworkErrorAlertMessageColor
|
verifyNetworkErrorAlertCancelColor
| verifyNetworkErrorAlertConfirmColor
|
ocrModule
exitIconBase64 | ocrTitleColor | ocrBorderColor |
albumBase64 | takePhotoBase64 | submitBase64 |
ocrSubmitTitleColor | ocrLoadingColor | ocrNetworkErrorAlertTitleColor |
ocrNetworkErrorAlertMessageColor | ocrNetworkErrorAlertCancelColor | ocrNetworkErrorAlertConfirmColor |
permissionFailedAlertTitleColor | permissionFailedAlertMessageColor | permissionFailedAlertConfirmColor |
docErrorAlertTitleColor | docErrorAlertMessageColor | docErrorAlertCancelColor |
docErrorAlertConfirmColor | failedAlertTitleColor | failedAlertMessageColor |
failedAlertConfirmationColor | failedAlertCancelColor | restrictionsAlertTitleColor |
restrictionsAlertMessageColor | restrictionsAlertConfirmationColor | timeoutAlertTitleColor |
timeoutAlertMessageColor | timeoutAlertConfirmationColor | exitAlertTitleColor |
exitAlertCancelColor | exitAlertConfirmationColor | ocrResultExitIconBase64 |
ocrResultTitleColor | ocrResultTipBGColor | ocrResultTipColor |
ocrResultInfoTitleColor | ocrResultInfoContentColor | ocrResultConfirmBtnEnabledBGColor |
ocrResultConfirmBtnEnabledTitleColor | ocrResultTipTitleColor | ocrResultTipIconBase64 |
ocrResultErrorTipBGColor | ocrResultInfoborderColor | ocrResultConfirmBtnDisabledBGColor |
ocrResultConfirmBtnDisabledTitleColor | ocrResultExitAlertTitleColor | ocrResultExitAlertCancelColor |
ocrResultExitAlertConfirmationColor | ocrResultNetworkErrorAlertTitleColor | ocrResultNetworkErrorAlertMessageColor |
ocrResultNetworkErrorAlertConfirmColor | ocrResultInfoErrorAlertMessageColor | ocrResultInfoErrorAlertConfirmColor |
ocrResultLoadingColor | ocrGuideExitIconBase64 | ocrGuideTitleColor |
ocrGuideContentColor | ocrGuideStartBtnTextColor | ocrGuideStartBtnBGColor |
ocrGuideIndicatorUnSelectedColor | ocrGuideIndicatorSelectedColor | nfcTitleColor |
nfcContentColor | nfcConfirmBtnBGColor | nfcConfirmBtnTextColor |
nfcInputCheckAlertMessageColor | nfcInputCheckAlertConfirmColor | nfcInputPassportEditHintColor |
nfcInputBirthdayEditHintColor | nfcInputValidityEditHintColor | nfcInputPassportLabelColor |
nfcInputBirthdayLabelColor | nfcInputValidityLabelColor | nfcInputBirthdayEditColor |
nfcInputValidityEditColor | nfcInputPassportEditColor | nfcInputTitleColor |
nfcInputBackAlertTitleColor | nfcInputBackAlertCancelColor | nfcInputBackAlertConfirmColor |
nfcInputNextBtnTextSelectColor | nfcInputNextBtnBGSelectColor | nfcReadBackAlertTitleColor |
nfcReadBackAlertConfirmColor | nfcReadBackAlertCancelColor | ocrAlbumLabelColor |
ocrTakePhotoLabelColor | ocrGuideStartBtnDisableTextColor | ocrGuideStartBtnDisableBGColor |



















































































































