# Пользовательские дополнения

На главную

## avatar.GetQuestProgress( questId )

Получить информацию о состоянии конкретного задания, находящегося в журнале заданий аватара.

См. avatar.GetQuestObjectiveInfo( objectiveId ).

См. QuestLocation.

    -- библиотека
    avatar

    -- объявление:
    function GetQuestProgress( questId )

    -- параметры
    questId: QuestId - идентификатор квеста

    -- возвращаемые значения: nil или таблица с описанием задания вида:
    id: QuestId - идентификатор квеста

    state: number (enum QUEST_XXX) - состояние квеста
      QUEST_IN_PROGRESS
      QUEST_READY_TO_RETURN
      QUEST_COMPLETED
      QUEST_FAILED

    returnLocation: QuestLocation or nil - если нет ошибки, то точка возвращения задания
    zonesMapId: ObjectId or nil - идентификатор интерфейсной карты задания (если не произошло ошибки)

    timerDurationMs: number (int) / nil - продолжительность таймера (nil если таймер отсуствует или неактивен)
    timerTimeLeftMs: number (int) / nil - оставшееся время таймера (nil если таймер отсуствует или неактивен)

    objectives: table of ObjectId - список (индекс с 0) ID целей квеста.

Пример:

    local progress = avatar.GetQuestProgress( questId )
    if progress then
      common.LogInfo( "Quest Progress: " )
      common.LogInfo( "  quest.id: "..progress.id );
      common.LogInfo( "  quest.state: "..progress.state );
      local objectives = progress.objectives;
      for index, objectiveItem in objectives do
        local objective = avatar.GetQuestObjectiveInfo( objectiveItem.id )
        LogInfo( "  index: ", index )
        LogInfo( "  objective.id: ", objective.id )
        LogInfo( "  objective.name: ", objective.name )
        LogInfo( "  objective.progress: ", objective.progress )
        LogInfo( "  objective.required: ", objective.required )
        if objective.items then
          LogInfo( "  objective.items[0]: ", objective.items[0] )
        end
      end
    end

#### Связанные страницы: "CategoryLuaApi" "CategoryQuest"

CategoryQuest
EnumQuestFindNextQuestMode
EnumQuestType
EventCurrentQuestChanged
EventInteractionStarted
EventItemQuestsReceived
EventNavigatorObjectReached
EventQuestAbandoned
EventQuestAcceptError
EventQuestBookChanged
EventQuestBookLimitsChanged
EventQuestCompleted
EventQuestDiscarded
EventQuestFailed
EventQuestFindNextResult
EventQuestFinishFailedNoSpace
EventQuestMarkUpdated
EventQuestObjectiveUpdated
EventQuestReadyToReturnChanged
EventQuestReceived
EventQuestShareInvitation
EventQuestShareInvitationCanceled
EventQuestShareInvitationFailed
EventQuestShareInvitationTimeout
EventQuestSkipResult
EventQuestStartFailedLogFull
EventQuestStartFailedNoSpace
EventQuestTimerFinished
EventQuestTimerUpdated
EventQuestUpdated
FunctionAvatarAcceptQuest
FunctionAvatarAcceptShareQuest
FunctionAvatarDeclineShareQuest
FunctionAvatarDiscardQuest
FunctionAvatarFindNextQuest
FunctionAvatarFindNextSecretComponentQuest
FunctionAvatarGetAvailableItemQuests
FunctionAvatarGetAvailableQuests
FunctionAvatarGetCurrentQuest
FunctionAvatarGetQuestAstralUnlocks
FunctionAvatarGetQuestBook
FunctionAvatarGetQuestHistory
FunctionAvatarGetQuestImage
FunctionAvatarGetQuestInfo
FunctionAvatarGetQuestObjectiveInfo
FunctionAvatarGetQuestProgress
FunctionAvatarGetQuestReward
FunctionAvatarGetQuestShareInvitations
FunctionAvatarGetQuestsLimit
FunctionAvatarGetReturnableQuests
FunctionAvatarGetSkipQuestCost
FunctionAvatarRequestInteractions
FunctionAvatarRequestItemQuests
FunctionAvatarRequestQuestsForItem
FunctionAvatarReturnQuest
FunctionAvatarSetCurrentQuest
FunctionAvatarShareQuest
FunctionAvatarSkipQuest
FunctionCartographerGetQuestGeodata
FunctionCartographerGetQuestObjectiveGeodata
FunctionCartographerGetZonesMapQuests
FunctionCartographerIsFinalQuestCompleted
FunctionCartographerNavigateToRule
FunctionDeviceGetRelatedQuestObjectives
FunctionObjectGetInteractorQuests
FunctionUnitGetRelatedQuestObjectives
QuestId
QuestLocation

CategoryLuaApi CategoryFunction CategoryQuest CategoryAvatar

На главную