Dokumentacja Orbitvu

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

Na tej stronie