현재 지역의 인앱 구매 품목 금액 가져오기

기능

게임 내 상품에 현재 지역의 금액과 통화를 표시해야 하는 경우, 이 인터페이스를 호출하여 현재 구성된 인앱 구매 품목이 현재 지역 통화의 금액과 통화에 해당하는 정보를 가져옵니다.

---

함수

-(void)getLocalGoodsInfoV2:(void (^)(NSDictionary * _Nullable info, NSError * _Nullable error))callback;

---

콜백

매개변수명	빈 값 가능(예/아니오)	설명
info	예	info는 dictionary이며, key는 가격 등급이고 value는 해당 가격 정보입니다. 예시: @{ @"0.99" : { @"amount" : @"8" , @"currency" : @"HKD",@"currencySymbol": @"HK$", @"formattedPrice" : @"HK$8" } }
error	예	오류 정보

key는 가격 등급

매개변수명	빈 값 가능(예/아니오)	설명
{priceKey}	아니오	인앱 구매 품목의 가격 등급이며 예를 들어 0.99입니다. value는 아래 표와 같이 가격 정보를 포함하는 dictionary입니다.

value는 해당 가격 정보

매개변수명	빈 값 가능(예/아니오)	설명
amount	아니오	스토어가 반환한 순수 숫자 금액으로 통화 기호, 통화 코드, 천 단위 구분 기호 및 공백을 포함하지 않습니다. 소수점은 항상 .을 사용하며 의미 없는 끝의 0은 제거됩니다.
currency	아니오	스토어가 반환한 ISO 4217 통화 코드이며 TWD, HKD, USD 등이 있습니다. 통화 식별에는 이 필드를 사용하고 $와 같은 기호로 통화를 추정하지 마세요.
currencySymbol	아니오	기기의 Locale에서 가져온 일반적인 통화 기호입니다. 언어, 지역 및 시스템 버전에 따라 $, NT$ 또는 TWD로 표시될 수 있으며 formattedPrice의 기호와 완전히 일치한다고 보장할 수 없습니다.
formattedPrice	아니오	사용자에게 바로 표시할 수 있는 완전한 현지화 가격으로, 스토어가 결정한 통화 기호, 금액, 소수 자릿수, 그룹 구분 기호 및 기호 위치를 포함합니다. 이 필드에서 amount 또는 currencySymbol을 다시 파싱하지 마세요.

사용 권장 사항

• 가격을 UI에 직접 표시할 때는 formattedPrice를 우선 사용하세요.
• 금액과 기호를 직접 배치해야 할 때는 amount와 currencySymbol을 사용하되, 기호 위치와 간격은 직접 처리하세요. 기호가 항상 금액 앞에 있다고 가정하지 마세요.
• 통화를 식별하거나 기록할 때는 currency를 사용하고 currencySymbol로 통화를 판단하지 마세요.
• 외부 가격 등급을 상품 ID로 사용하지 마세요.
• 콜백이 실패할 때는 USD를 대체 방안으로 사용하는 것을 권장합니다.

---

예제 코드

    [[GamedreamerManager shareInstance] getLocalGoodsInfoV2:^(NSDictionary * _Nullable info, NSError * _Nullable error) {
        if (error) {
            NSLog(@"오류 정보: %@",error);
        } else {
            NSLog(@"품목 현지화 가격 정보: %@",info);
        }
    }];