====== Musik über mehrere Seiten hinweg abspielen ======

SoSci Survey bietet die Möglichkeit mithilfe eines Framesets Musik oder ein Video über einen gesamten Fragebogen hinweg darzubieten. Wie das geht erklärt folgende Anleitung((Danke an [[sbrand@students.uni-mainz.de|Sebastian Brand]] für dieses Kapitel.)).


===== Ein Frameset definieren =====

Zu allererst müssen Sie ein Frameset innerhalb von SoSci Survey anlegen. Was genau man unter einem Frameset versteht ist hier nachzulesen: [[http://wiki.selfhtml.org/wiki/HTML/Frames|SelfHTML: Frames]]. Grob gesagt ist ein Frameset eine Art Tabelle, die die angezeigte Website in einzelne Bereiche aufteilt, deren Inhalte individuell bearbeitet werden können.

Um ein Frameset in SoSci Survey zu zu erstellen, muss zunächst eine Textdatei auf dem eigenen Desktop angelegt werden. Diese Textdatei wird dann z.B. "Start.html" benannt.

**Wichtig:** Es ist essenziell, dass die Datei als reiner ASCII-Text gespeichert wird. Verwenden Sie daher zum Erstellen/Bearbeiten der Datei einen Texteditor (z.B. [[https://notepad-plus-plus.org/|Notepad++]], [[http://www.scintilla.org/SciTE.html|SciTE]] oder das Windows-eigene Notepad) und __kein__ Textbearbeitungsprogramm wie Word oder OpenOffice.

**Wichtig:** Achten Sie darauf, dass die Dateiendung entsprechend geändert wird, sodass aus der ehemaligen Textdatei eine HTML-Datei wird. Sie können den Inhalt dieser dann mittels Editor anpassen. Innerhalb der Datei muss nun folgender HTML Code stehen:

<code html>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=utf-8">
    <title>Fragebogen</title>
  </head>
  <frameset rows="99%, 1%">
    <frame src="https://www.soscisurvey.de/PROJEKT/" name="survey">
    <frame name="Beispielframe">
  </frameset>
</html>
</code>

Achten Sie auf die Zeile ''<frame src=...'' -- hier müssen Sie ihre individuelle Fragebogen-URL eintragen ([[:de:survey:url]]), um in einem Frame den Fragebogen zu starten. Den eigenen Bedürfnissen entsprechend können Sie außerdem folgende Veränderungen im Code vornehmen:

  * Das Attribut ''rows'' kann durch ''cols'' ersetzt werden, um statt einer Aufteilung der   angezeigten Seite in Zeilen (Frames untereinander) eine Aufteilung in Spalten (Frames nebeneinander) zu erhalten.
  * Die prozentuale Aufteilung der Bereiche kann angepasst werden.
  * Die Frames können anders benannt werden (Attribut ''name'').
  * Es können weitere Frames hinzugefügt werden -- beachten Sie dabei aber, dass sich die Spalten- bzw. Reihenprozente insgesamt zu 100 addieren.
  * Mit dem Befehl ''%%border="0"%%'' können die Rahmen um die einzelnen Frames entfernt werden.
 
Nachdem Sie die Datei angelegt und fertig bearbeitet haben, können Sie diese unter **Bilder und Mediendateien** in Ihr Projektverzeichnis hochladen. Sie können das Ergebnis nun betrachten, indem sie an die URL Ihres Projektverzeichnis noch ''/start.html'' anhängen, z.B. ''%%https://www.soscisurvey.de/PROJEKT/start.html%%''

**Wichtig**: Verwenden Sie beim Hochladen __nicht__ die geschützte Dateiablage!


===== Frameinhalte vorbereiten =====

Zunächst müssen Sie sich entscheiden, was für Inhalte in einen Frame geladen werden sollen. Der Frame sollte natürlich bei einem Video entsprechend groß sein, damit dieses komplett zu sehen ist. Bei Musik so klein wie möglich, um den eigentlichen Fragebogen nicht zu sehr zu verdecken. 
Wenn sie wissen, welcher Inhalt in den Frame geladen werden soll, müssen Sie für diesen erneut eine Text- bzw. HTML-Datei auf dem Desktop anlegen, z.B. ''play.html''. Nun editieren Sie diese Datei und füllen sie mit dem HTML Code, welcher Ihren Inhalt abspielt. Hier am Beispiel für Musik:

<code html>
<!DOCTYPE html>
<html lang="de">
  <head>
    <meta charset="utf-8">
    <title>Audio</title>
  </head>
  <body>
    <audio id="bgAudio01" preload autoplay style="position: absolute; left: -9999px; top: -9999px">
      <source src="Beispiel.mp3">
    </audio>
  </body>
</html>
</code>

Hier wurde die Audio-Datei über das ''<audio>''-Tag eingebunden, was mittlerweile viele Browser unterstützen. Eine Einbindung mittels Flash-Player wird unter [[:de:create:media]] beschrieben.

Die Musikdatei (Hier „BEISPIEL.MP3“) müssen Sie natürlich ebenfalls in SoSci Survey hochladen. Damit kein Player mehr angezeigt wird, sondern die Musik quasi unsichtbar im Hintergrund läuft, wurde der Player im absolut negativen Bereich platziert (Pixel -9999). Die editierte Datei laden Sie nun auch in Ihr Projektverzeichnis hoch.

**Tipp:** Um die Bezeichnung der Audiodatei zu ermitteln, gehen Sie im Fragebogen-Menü Ihres Projektes auf Bilder und Dateien, dort finden Sie die volle Bezeichnung, welche Sie einfach kopieren können (in der Regel der Name unter dem Sie die Datei hochgeladen haben). 


===== Frame-Inhalte laden =====

Womöglich möchten Sie die Audio-Datei nicht sofort zu Beginn des Fragebogens abspielen, sondern erst ab einer bestimmten Seite. Dafür laden sie die eben angelegte Datei ''play.html'' via JavaScript in das kleine Frame. Um das zu erreichen, legen Sie unter **Textbausteine und Beschriftung** einen neuen Textbaustein mit folgendem HTML-Inhalt an:

<code html>
<script type="text/javascript">
<!--
top.Beispielframe.location.href = "play.html";
// -->
</script>
</code>

Wenn Sie diesen Textbaustein nun auf einer Ihrer Fragebogen-Seite einfügen, wird automatisch der Inhalt des Frames verändert und ihre Musik oder Ihr Video hineingeladen.


===== Frame-Inhalte entfernen =====

Um den Frame wieder zu leeren und die Musik verstummen zu lassen, laden Sie einfach eine leere HTML Seite in ihren Frame. Am besten legen Sie dazu ein leeres HTML Dokument auf ihrem Desktop an, welches Sie ''leer.html'' benennen. Wie der Name schon sagt, lassen Sie diese Datei leer und laden sie dann so hoch. Sie können nun mit folgendem Befehl die Musik stoppen.

<code html>
<script type="text/javascript">
<!--
top.Beispielframe.location.href = "leer.html";
// -->
</script>
</code>


===== Fragebogen mit Frameset verschicken =====

Um das Frameset nun vollständig zu nutzen muss der Link zum Fragebogen mit der Endung /start.html ergänzt werden (oder dem invidivuellen Namen Ihres Framesets). Dies dürfen Sie nicht vergessen, sonst funktioniert es nicht. Wie sich der Link zum Fragebogen zusammen setzt können Sie hier nachlesen: [[de:survey:url|]]


===== Einschränkungen =====

  * Beim Aufrufen des Frameset können Sie keine Variablen (z.B. Referenz oder Seriennummer) an den Fragebogen übermitteln, wie unter [[:de:survey:url]] beschrieben.
  * Es ist mit dieser Lösung nicht möglich, die Musik am Ende auszublenden, sie endet beim Laden der leeren Datei einfach abrupt.