호출 방법
addon.Platform:GetUnitCreatureTypeID(unit)
addon을 통해 바로 쓸 수 있으며, 의존성이 필요 없습니다.
하는 일
점검 또는 제한 정책 클라이언트에서 기본 UnitCreatureType의 두 번째 반환값으로 생물 식별 정보를 관찰합니다. 먼저 정확한 UnitExists(unit)를 확인하며, false로 읽히면 생물 메타데이터를 요구하거나 호출하지 않고 false를 반환합니다. 있는 유닛은 읽을 수 있는 유한한 숫자 ID가 필요하며, 사용하지 않는 현지화 이름은 사용 가능 여부에 영향을 주지 않습니다. 부호 있는 값, 소수, 0, 향후의 유한한 ID도 알려진 값으로 보존합니다. 필수 정보가 없거나, 실패하거나, nil이거나, 제한되거나, 잘못되면 nil과 이유를 반환합니다. 생물 나열, 번역된 이름표 비교, 장기 캐시는 추가하지 않습니다.
인수
| 이름 | 유형 | 하는 일 |
|---|---|---|
self | RMPlatform | Rotation Master 플랫폼 어댑터 (콜론 호출에서는 암묵적). |
unit | string | 존재 및 생물 메타데이터 조회에 유일한 인수로 그대로 전달되는, 읽을 수 있는 비어 있지 않은 선택 유닛 토큰. |
반환값
| 1 | number | boolean | nil | 유한한 기본 생물 ID, 유닛이 없는 것으로 알려지면 false, 필수 관찰을 사용할 수 없으면 nil. |
|---|---|---|
| 2 | string | nil | nil인 ID에 대한 정책, 조회 검증 또는 필수 관찰 사용 불가 이유. |
버전
기본 제공 도우미는 모든 버전에 등록됩니다. 다른 점은 읽는 게임 API이며, API가 없으면 도우미는 대체 동작을 하거나 이유와 함께 nil을 반환합니다.
- 해당 버전에서 사용할 수 없음 (이유는 툴팁에 표시)
- Blizzard의 지원 중단 대체 함수가 켜져 있을 때만
비공개 값 (Retail과 Forever)
Retail과 Forever에서는 게임이 애드온에 비공개 값을 넘깁니다. 이 도우미는 읽는 값을 확인하고(addon.Platform:CanReadValue), 비교할 수 없는 비공개 값 대신 restricted-value 같은 이유와 함께 nil을 반환합니다. nil은 거짓이 아니라 사용할 수 없음으로 취급하세요.
예시
local id = addon.Platform:GetUnitCreatureTypeID("target")
if id == nil then return nil end
-- false (no target) never equals 6, the Undead creature type.
return id == 6소스
Platform/creature_type.lua, 17번째 줄. 게임에서는 읽기 전용이며, 복제하면 편집 가능한 사본이 생깁니다.
Platform.creature_type.GetUnitCreatureTypeID(self, unit)
local policy=self:GetCombatDataPolicy()
if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
if not self:CanReadValue(unit) then return nil,'restricted-value' end
if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
if type(UnitExists)~='function' then return nil,'missing-api' end
local existsOk,exists=pcall(UnitExists,unit)
if not existsOk then return nil,'api-error' end
if not self:CanReadValue(exists) then return nil,'restricted-value' end
if exists==nil then return nil,'unit-data-unavailable' end
if type(exists)~='boolean' then return nil,'invalid-api-result' end
if not exists then return false end
local native=UnitCreatureType
if type(native)~='function' then return nil,'missing-api' end
local observed,_,id=pcall(native,unit)
if not observed then return nil,'api-error' end
if not self:CanReadValue(id) then return nil,'restricted-value' end
if canaccessvalue and not canaccessvalue(id) then return nil,'restricted-value' end
if id==nil then return nil,'unit-creature-type-unavailable' end
if type(id)~='number' or id~=id or id==math.huge or id==-math.huge then return nil,'invalid-api-result' end
return id