API 지원을 위한 동적 조명

프로그래밍 마법사이거나 Roll20 API와 함께 작업하는 것을 좋아하나요? 그렇다면, 좋은 소식이 있습니다 - 동적 조명이 이제 Roll20 API와 통합되었습니다! 사용자 정의 코드에서 사용할 수 있는 멋진 조명 및 시야 기능을 모두 확인해보세요. 참고로, API 액세스는 Pro 구독자에게만 제공됩니다. 따라서 아직 업그레이드하지 않았다면 계정을 업그레이드하세요.


토큰 설정

구문 맥락 유형
has_bright_light_vision  토큰의 시야를 토글합니다. Boolean
has_night_vision 토큰의 야간 시야를 토글합니다.  Boolean
night_vision_distance 토큰의 야간 시야 범위를 설정합니다.  정수
emits_bright_light 토큰에 밝은 빛을 토글합니다.  Boolean
bright_light_distance 토큰에서 발산되는 밝은 빛의 범위를 설정합니다.  정수
emits_low_light 토큰에 어두운 빛을 토글합니다. 이는 횃불이나 적은 양의 빛이 있는 원본에 유용합니다. booleans true를 켜거나 false를 끌 때 사용합니다. Boolean
low_light_distance 토큰에서 발산되는 어두운 빛의 범위를 설정합니다. 이 값을 설정할 때 설정한 밝은 빛 범위를 포함해야 합니다. 이는 Low Light Distance가 토큰의 중심으로부터 계산되기 때문입니다. 따라서 Bright Light Distance를 10으로 설정하고 추가로 10피트의 Low Light Distance가 필요한 경우, low_light_distance의 값은 20이어야 합니다. 정수 
light_sensitivity_multiplier Multiplier on the effectiveness of light sources. A multiplier of 200 would allow the token to see twice as far as a token with a multiplier of 100, with the same light source. 정수
night_vision_effect
Changes the Night Vision Effect. Other options include “Dimming” and “Nocturnal” 문자열

 

방향성 시야 및 조명

구문 문맥 유형
has_limit_field_of_vision 토큰의 시야 제한을 토글합니다.. Boolean
limit_field_of_vision_center 시야의 중심이 시작되는 위치를 설정합니다. 정수
limit_field_of_vision_total Set the value for the total size of the field of vision. Integer

has_limit_field_of_night_vision

Toggles limit field of night vision for the token. Boolean
limit_field_of_night_vision_center Sets the value for where the center of the field of night vision starts. Integer 
limit_field_of_night_vision_total Set the value for the total size of the field of night vision. Integer
has_directional_bright_light Toggles directional bright light for the token. Boolean

방향성 밝은 빛 중앙

밝은 빛 영역의 중앙 위치를 설정합니다. 정수
방향성 밝은 빛 전체 밝은 빛 영역의 전체 크기를 설정합니다. 정수 

방향성 어두운 빛 사용

토큰에 대한 방향성 저조도를 토글합니다. Boolean
방향성 어두운 빛 중앙 어두운 빛 영역의 중앙 위치를 설정합니다. 정수
방향성 어두운 빛 전체 어두운 빛 영역의 전체 크기를 설정합니다. 정수

 


페이지 설정

구문 문맥 유형
dynamic_lighting_enabled 페이지에 대한 업데이트된 동적 조명을 토글합니다.  Boolean
daylight_mode_enabled 페이지에 대한 주간 모드를 토글합니다. 만약 dynamic_lighting_enabled가 꺼져 있다면 이 기능을 켜지 않습니다.  Boolean
explorer_mode

페이지에 대한 탐색 모드를 토글합니다. 만약 dynamic_lighting_enabled가 꺼져 있다면 이 기능을 켜지 않습니다.

”basic”을 입력하면 켜지고, ”off”를 입력하면 꺼집니다. 

문자열

force_lighting_refresh

페이지의 모든 토큰 조명/시야를 새로고침합니다. 여러 토큰을 페이지에 추가한 후에 한 번의 호출로 사용할 수 있습니다. (Will be deprecated in the coming months!) 

Boolean

fog_opacity

Opacity of the fog of war for the GM.

Boolean

lightupdatedrop

Only update Dynamic Lighting when an object is dropped.

Boolean

 


Examples 

on("change:graphic", function(obj) {
  obj.set({
    has_bright_light_vision: true,
    emits_bright_light: true,
    bright_light_distance: 10
  });
});

This will add the above values to atokenin two instances:

  • upon adding a newtokento theVTT
  • moving atokenthat already exists on theVTT, with or withouttokensettings already set.

However, using on(“change is dangerous because if you update thetokensettings for a specifictoken, that triggers a change event, which will trigger this API. So, if you have something like this in your API script, your token settings will always stay this way for every token, unless you add some conditional statements so it works the way you want.

on("change:graphic", function(obj) {
  obj.set({
    has_bright_light_vision: true,
    emits_bright_light: true,
    bright_light_distance: 10,
    emits_low_light: true,
    low_light_distance: 25
  });
});

This example will set Vision to any token that has changed (moved, updated, added to the VTT, etc). The token will also emit 10 feet of Bright Light Distance, as well as 15 feet of Low Light Distance.

Notice how low_light_distance is set to 25. 그것은low_light_distance의 값이bright_light_distance의 합과토큰이 발산하는 낮은 빛의 거리 - 이 경우에는15이어야 한다.

 

도움이 되었습니까?
69명 중 43명이 도움이 되었다고 했습니다.