Dostosowywanie embed code ORBITTOUR – lista parametrów
Wszystkie parametry embed code ORBITTOUR wraz z dopuszczalnymi wartościami i wartościami domyślnymi.
Korzystając z embed codes ORBITTOUR, możesz dostosować wygenerowany kod. Bywa to konieczne w niektórych przypadkach, np. gdy chcesz osadzić ten sam ORBITTOUR kilka razy na jednej stronie albo dynamicznie załadować/wstrzyknąć ORBITTOUR za pomocą JavaScript.
Z ORBITTOUR możesz też używać większości parametrów ORBITVU VIEWER.
Parametry ORBITTOUR można stosować w embed code wygenerowanym przez ORBITVU SUN.
Przykład dodania parametru teaser:
<div id="orbittour-hhyoAwhnuh2NQLgNfpdRYk" class="orbittour-container"></div>
<script type="text/javascript" src="//orbitvu.co/share/hhyoAwhnuh2NQLgNfpdRYk/523/orbittour/script?teaser=autorotate"></script>background_color
Ustawia kolor tła ORBITTOUR. Wartość tego parametru należy podać jako szesnastkowy numer koloru (taki sam jak w HTML) + szesnastkową wartość przezroczystości, np.:
- 000000ff kod koloru: 000000 (czarny) i wartość krycia: ff (nieprzezroczysty)
- 00000000 (przezroczysty) kod koloru: 000000 i wartość krycia: 00 (przezroczysty)
nosize_ratio
Pozwala ustawić własne proporcje dla ORBITTOUR, gdy jego kontener nie ma zdefiniowanych wymiarów, np. wysokość wynosi 0px. W takiej sytuacji ORBITTOUR wyświetlany jest w domyślnych proporcjach 16/9 (szerokość/wysokość).
Wartości: n/n
Przykład: 4/3
Domyślnie: 16/9
orbittour_uid
Ustaw na unikalną wartość, jeśli chcesz osadzić ten sam ORBITTOUR kilka razy na jednej stronie. Dzięki temu zarówno id elementu kontenera ORBITTOUR, jak i funkcja wstrzykująca ORBITTOUR (JavaScript) będą miały unikalne nazwy w obrębie strony.
Domyślnie: unikalny uid prezentacji w ORBITVU SUN
Przykład: myuid_1
orbittour_container_id
Możesz jawnie ustawić id elementu kontenera ORBITTOUR
Domyślnie: orbittour-<orbittour_uid>
preferred_language
Możesz wymusić na ORBITTOUR użycie konkretnego języka (o ile ORBITTOUR ma tłumaczenia dla tego języka)
Domyślnie: nie ustawiono — język zostanie wybrany automatycznie na podstawie preferencji językowych przeglądarki
Wartość: kod języka z listy dostępnych tłumaczeń ORBITTOUR, np. en, de
orbittour_width
ORBITTOUR próbuje automatycznie obliczyć swój rozmiar na podstawie wymiarów kontenera, ale w niektórych przypadkach konieczne może być jawne ustawienie width i height. Na przykład jeśli ORBITTOUR jest inicjowany wewnątrz ukrytego kontenera (z display: none), obliczenie prawidłowych wymiarów nie będzie możliwe.
Domyślnie: nie ustawiono — obliczane automatycznie
orbittour_height
ORBITTOUR próbuje automatycznie obliczyć swój rozmiar na podstawie wymiarów kontenera, ale w niektórych przypadkach konieczne może być jawne ustawienie width i height. Na przykład jeśli ORBITTOUR jest inicjowany wewnątrz ukrytego kontenera (z display: none), obliczenie prawidłowych wymiarów nie będzie możliwe.
Domyślnie: nie ustawiono — obliczane automatycznie
orbittour_delayed
Domyślnie ORBITTOUR zostanie natychmiast wstrzyknięty na stronę, ale jeśli chcesz wstrzyknąć go później, możesz zablokować natychmiastowe wstrzyknięcie parametrem orbittour_delayed, a następnie wywołać funkcję wstrzykującą programowo, gdy będzie potrzebna. Funkcja wstrzykująca ORBITTOUR to:
inject_orbittour_(<orbittour_id>)
Wartości: yes | no
Domyślnie: no
orbittour_style
Zmienia styl używany przez ORBITTOUR:
Wartości: default | right_views | noviews
Domyślnie: używana jest wartość ustawiona dla ORBITTOUR w ORBITVU SUN
custom_viewer
Jeśli masz własną licencję VIEWER, np. na VIEWER o dostosowanym wyglądzie, możesz używać go z ORBITVU SUN. Wejdź w preferencje swojego konta Orbitvu SUN i wyślij własny VIEWER (archiwum zip). Od tego momentu możesz dodawać custom_viewer=yes do embed codes, aby używać swojej kopii ORBITVU VIEWER.
Wartości: yes | no
Domyślnie: no
exernal_init
Nazwa globalnie dostępnej funkcji JavaScript, która zostanie wywołana po zainicjowaniu ORBITTOUR. Do funkcji przekazywany jest obiekt API udostępniający metody sterowania ORBITTOUR, np.:
<script type="text/javascript">
var orbittour_api = null;
window['my_orbit_init'] = function(orbit_api){
orbittour_api = orbit_api;
}
// (...)
function call_on_dynamic_resize(){
if (orbittour_api){
orbittour_api.handle_resize();
}
}
</script>Nazwę metody przekazuje się w ten sposób:
<div id="orbittour-hhyoAwhnuh2NQLgNfpdRYk" class="orbittour-container"></div>
<script type="text/javascript" src="//orbitvu.co/share/hhyoAwhnuh2NQLgNfpdRYk/523/orbittour/script?external_init=my_orbit_init"></script>play_type
Ustawienie wartości innej niż none powoduje wyświetlenie przycisku play/pause. Po jego naciśnięciu ORBITTOUR zacznie animować przejścia między kolejnymi widokami lub hotspotami (zależnie od wartości play_type). Jeśli nie ma żadnych widoków ani hotspotów, przycisk play nie zostanie wyświetlony.
Wartości: none | views | hotspots
Domyślnie: no
play_time
Czas oczekiwania (w milisekundach) przed przejściem do następnego widoku lub hotspotu podczas odtwarzania animacji (gdy play_type jest ustawiony na views lub hotspots)
Wartości: 2500 | 3000 | 3500 | 4000 | 4500 | 5000 | 7500 | 10000
Domyślnie: 2500
play_auto
Włącza automatyczne odtwarzanie ORBITTOUR (jeśli play_type nie jest ustawiony na none). Odtwarzanie rozpocznie się 1 sekundę po załadowaniu prezentacji
Wartości: yes | no
Domyślnie: no
Dostosowywanie embed codes z ORBITVU SUN
Korzystając z embed codes z ORBITVU SUN, możesz dostroić wygenerowany kod do swoich potrzeb — na przykład gdy chcesz osadzić tę samą prezentację kilka razy na jednej stronie.
ORBITVU VIEWER API
API JavaScript ORBITVU VIEWER: metody, zdarzenia i sterowanie VIEWER-em z poziomu własnych kontrolek.