Platform.unit_flags.GetUnitFlagObservation

호출 방법

addon.Platform:GetUnitFlagObservation(unit, kind)

addon을 통해 바로 쓸 수 있으며, 의존성이 필요 없습니다.

하는 일

현재 유닛 플래그 하나를 관찰합니다. combat은 UnitAffectingCombat, enemy는 player를 첫 유닛으로 한 UnitIsEnemy, pvp는 UnitIsPVP를 사용합니다. 없다고 읽힌 유닛은 플래그를 조회하지 않고 false를 반환합니다. 필수 관찰이 없거나, 실패하거나, 제한되거나, 잘못되면 nil과 이유를 반환합니다. 정확히 선택한 유닛을 유지하며, 우호, 공격 가능 여부, 다른 유닛 상태를 추론하지 않습니다.

인수

이름	유형	하는 일
`self`	`RMPlatform`	Rotation Master 플랫폼 어댑터 (콜론 호출에서는 암묵적).
`unit`	`string`	선택한 플래그를 관찰할 정확한 유닛 토큰.
`kind`	`string`	combat, enemy, pvp 중 하나. 다른 플래그 종류는 지원하지 않습니다.

반환값

1	`boolean \| nil`	읽을 수 있는 선택 플래그, 없는 것으로 알려진 유닛이면 false, 필수 관찰을 사용할 수 없으면 nil.
2	`string \| nil`	nil인 유닛 플래그에 대한 정책, 조회 검증 또는 사용 불가 이유.

버전

기본 제공 도우미는 모든 버전에 등록됩니다. 다른 점은 읽는 게임 API이며, API가 없으면 도우미는 대체 동작을 하거나 이유와 함께 nil을 반환합니다.

해당 버전에서 사용할 수 없음 (이유는 툴팁에 표시)
Blizzard의 지원 중단 대체 함수가 켜져 있을 때만

게임 API
`UnitAffectingCombat`
`UnitExists`
`UnitIsEnemy`
`UnitIsPVP`

비공개 값 (Retail과 Forever)

Retail과 Forever에서는 게임이 애드온에 비공개 값을 넘깁니다. 이 도우미는 읽는 값을 확인하고(addon.Platform:CanReadValue), 비교할 수 없는 비공개 값 대신 restricted-value 같은 이유와 함께 nil을 반환합니다. nil은 거짓이 아니라 사용할 수 없음으로 취급하세요.

예시

local inCombat = addon.Platform:GetUnitFlagObservation("target", "combat")
local enemy = addon.Platform:GetUnitFlagObservation("target", "enemy")
if inCombat == nil or enemy == nil then return nil end
return enemy and not inCombat

의존성

readClientPolicy (builtin:Platform/unit_flags.lua:readClientPolicy)

소스

Platform/unit_flags.lua, 39번째 줄. 게임에서는 읽기 전용이며, 복제하면 편집 가능한 사본이 생깁니다.

Platform.unit_flags.GetUnitFlagObservation(self, unit, kind)

    local policy=readClientPolicy(self)
    if policy~='probe' and policy~='restricted' then return nil,'unsupported-policy' end
    if not self:CanReadValue(unit) or not self:CanReadValue(kind) then return nil,'restricted-value' end
    if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
    if kind~='combat' and kind~='enemy' and kind~='pvp' then return nil,'invalid-unit-flag-query' 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 api
    if kind=='combat' then api=UnitAffectingCombat
    elseif kind=='enemy' then api=UnitIsEnemy
    else api=UnitIsPVP end
    if type(api)~='function' then return nil,'missing-api' end
    local ok,result
    if kind=='enemy' then ok,result=pcall(api,'player',unit)
    else ok,result=pcall(api,unit) end
    if not ok then return nil,'api-error' end
    if not self:CanReadValue(result) then return nil,'restricted-value' end
    if result==nil then return nil,'unit-flag-unavailable' end
    if type(result)~='boolean' then return nil,'invalid-api-result' end
    return result

함수 레퍼런스(으)로 돌아가기