Programmierhandbuch

Hier sind einige Tipps, wie man das Verhalten von FV Player zu zwicken (2.1.32+).

• Verwendung von benutzerdefinierten Code, um einen Spieler zu erstellen
• WordPress Filter
• JavaScript Kurzanleitung
• Videolänge Bestimmung

Verwendung von benutzerdefinierten Code, um einen Spieler zu erstellen

Wir empfehlen Ihnen dringend dies zu vermeiden und lassen Sie uns wissen, was würden Ihre bevorzugte Methode der Veröffentlichung von Videos sein, wenn gefallen Ihnen unsere Shortcode nicht.

Wenn Sie Ihre eigene Schnittstelle mit benutzerdefinierten Feldern (post meta) bevorzugen, können Sie ein PHP-Code wie diesem verwenden:

if( function_exists('flowplayer_content_handle') && $meta = get_post_meta(get_the_ID(), 'my-field', true) ) {
  $args = array();
  $args['src'] = $meta;

  if( $splash = get_post_meta(get_the_ID(), 'my-field-for-splash-screen-url', true) ) {
    $args['splash'] = $splash;
  }
  echo flowplayer_content_handle( $args );
}

Verfügbare WordPress Filter

Wahrscheinlich wissen Sie bereits, wie WordPress Filter funktionieren, Sie können die Filter Referenz auf wordpress.org hier lesen.

Liste der verfügbaren Filter:

• fv_flowplayer_ad_html – ermöglicht Ihnen die Anpassung, was wird in die Werbung, die erscheint einmal, wenn beginnt das Video spielen. Sie können die globale Variable $post verwenden zu überprüfen, welcher Beitrag wird zur Verfügung gestellt.
• fv_flowplayer_autobuffer_limit – anpassen, wie viele Videos sollten automatisch gepuffert, wenn ist die Plugin Möglichkeit aktiviert. Der Standardwert ist 2.
• fv_flowplayer_amazon_expires – ermöglicht Ihnen die URL-Ablaufzeit in Sekunden anpassen. Erstes Argument ist die Video Dauer und das zweite ist die Datei-URL
• fv_flowplayer_amazon_secure_exclude – ermöglicht Ihnen die URL aus dem Zugriffstoken Addition Prozess auszuschließen. Datei-URL ist das Argument, zurückgibt true um die Datei zu überspringen.
• fv_flowplayer_attributes – erste Parameter ist ein Array aller DIV Element Attribute des Spielers, zweite ist die Video-URL. Sie können die globale $post Variable verwenden zu überprüfen, welcher Beitrag wird serviert. Die wichtigsten Eigenschaften sind:
  • class – CSS-Klasse des Elements
  • data-cuepoints – ermöglicht Ihnen die Cue-Points einstellen. Verwenden Sie Daten wie [10, 30, 60, 120]
  • data-embed – stellen Sie auf “false” um das Video Einbettung deaktivieren
  • data-engine – stellen Sie auf “flash” um Flash für das Video bevorzugen
  • data-fullscreen – stellen Sie auf “false” um die Vollbild-Option deaktivieren
  • data-key – Lizenzschlüssel
  • data-keyboard – stellen Sie auf “false” um die Tastenkombinationen zu deaktivieren
  • data-logo – Pfad zu Ihrem Spielerlogo. Dies funktioniert nur mit einem gültigen Lizenzschlüssel.
  • data-rtmp – stellen Sie den RTMP-Endpunkt-URL
  • style – das Inline-style Attribut des Spielers Container. Verwendet für die Videoabmessungen.
• fv_flowplayer_inner_html – ermöglicht Ihnen jeder HTML in den Player-Container einfügen, direkt nach den Video- und Popup-Elemente
  
  
• fv_flowplayer_popup_html – ermöglicht Ihnen den Popup-Inhalt anpassen, das wird sich am Ende des Video anzeigen. Sie können die globale $post Variable verwenden zu überprüfen, welcher Beitrag wird serviert.

Lassen Sie uns bitte wissen, wenn fehlen Ihnen irgendwelche Filter!

Beispiel

Fügen Sie eine Play-Taste zu Spieler Steuerleiste (Einfach getan, als ist es nur eine CSS-Klasse):

add_filter('fv_flowplayer_attributes', 'tweak_fv_flowplayer_attributes', 10, 2);
function tweak_fv_flowplayer_attributes($attrs) {
  $attrs['class'] .= ' play-button';

  return $attrs;
}

FV Player JavaScript API Verwendung

Wie Sie Ihren Code hinzufügen

Verwenden Sie den Standard WordPress-Filter genannt wp_footer. Das folgende Codebeispiel (Sie können es entweder in einen neuen Plugin oder in functions.php Ihrer Template setzen) prüft die Beitrag Meta-Feld, und wenn es gefunden wird, es zurückgibt ein JavaScript, das wird ausgelöst, wenn Sie das Video abspielen:

add_action('wp_footer', 'my_fv_flowplayer_scripts', 10, 3);
function my_fv_flowplayer_scripts( $script ) {
  global $post;

  if( get_post_meta($post->ID, 'tweak_player', true) ) {
    $args = func_get_args();
    $script .= "
    jQuery('#$args[1]').bind('ready', function() {
      alert( 'Video just started!' );
    });
    ";
  }
  return $script;
}

Dies könnte verbessert (zum Beispiel) auslösen eine benutzerdefinierte Funktion das stoppt das Video nach 5 Sekunden Wiedergabe und zeigt einige Popup. Sie können natürlich auch einige von den FV Player API Ereignisse verwenden.

Sie können auch einen Code wie diesen in jedem Ihrer JavaScript-Dateien setzen und alle Spieler betreffen. Das gleiche Beispiel wie oben, aber dieses Mal ist nur der erste Spieler auf jeder Seite betroffen:

<script>
if( typeof(flowplayer) != "undefined" ) {
  var api = flowplayer(0);

  api.bind('ready', function() {
    alert( 'Video just started!' );
  });

}
</script>

Sie können auch den Code in das Fußzeile Ihrer Template setzen. Aber gegenprüfen Sie, dass es mit Ihrem Minify Plugin funktioniert, wenn Sie einen verwenden.

Wichtige API-Methoden

• disable(flag) – setzen sie den Flag auf true um zu deaktivieren-, false zu aktivieren den Spieler
• fullscreen() – Vollbild hin- und herschalten
• load(video) – Video sollte ein Array sein wie: [{ mpegurl: 'http://meinedomain.com/mein/anderes/video.m3u8'}, {webm: 'http://meinedomain.com/mein/anderes/video.webm'}, {mp4: 'http://meinedomain.com/mein/anderes/video.mp4'}, {ogg: 'http://meinedomain.com/mein/anderes/video.ogv'}]
• next() und prev() – nächsten und vorherigen Playlist Element
• pause() – Anhalten das Video
• play(index) – abspielt das Video, verwenden Sie Index zu spezifizieren die Position in der Wiedergabeliste
• resume() – Fortsetzen die Wiedergabe nach Pause
• seek(time) – Suchvorgang auf Zeit
• stop() – stoppt die Wiedergabe und kehrt zum Anfang des Video
• unload() – Entladen der Spieler+
• volume() – einstellt Spieler Lautstärke

Verwendung wie in obigen Beispielen:

api.disable(false);

Wichtige API Ereignisse

• beforeseek – wenn der Suchvorgang beginnt. Das dritte Argument ist die Suchvorgang Zielzeit.
• cuepoint – wenn ist cuepoint erreicht. Das dritte Argument ist ein Objekt mit Cue-Zeit und Index.
• error – wenn ein Fehler auftritt. Das dritte Argument ist das Objekt mit der Beschreibung des Fehlers.
• finish – wenn ist die Wiedergabe beendet.
• fullscreen und fullscreen-exit – beim den Start / schließen der Vollbild Wiedergabe
• load – erste Spieler Ereignis, bevor beginnt das Video zu spielen
• mute und volume – Auslöser auf stumm oder die Lautstärke Änderung
• pause and stop – Auslöser auf Pause / Stopp-Aktion
• progress – erfolgt alle 250 ms, wenn das Video abgespielt wird
• ready – Sobald das Video geladen ist.
• seek – Suchvorgang war abgeschlossen
• unload – wenn der Spieler geht zurück in den Ausgangszustand.

Schnelle JavaScript Beispiele

Setzen Sie immer Ihre Skripte in wp_footer hook oder einfügen sind sie in footer.php unter wp_footer() Ruffunktion.

1. Spieler Initialisierung via JavaScript

Stellen Sie sicher, dass hat der Element Dimensionen gesetzt oder setzen Sie sie via JavaScript. Stellen Sie sicher, dass ist kein bestehende Video-Tag in dem Element, als FV Player wird dass stattdessen verwenden:

jQuery('#your-element').flowplayer( {
  playlist: [
    [ { mp4: "http://example.com/videos/file.mp4"} ]
  ]
} );

Wenn Sie das Video mit einem anderen ersetzen möchten, können Sie das Element entweder entfernen und einen neuen mit neuen Spieler einfügen, oder eine andere API Ruffunktion machen um das spielende Video ersetzen.

2. Wie verwenden die oben genannten API-Methoden

Wählen Sie einfach Ihr Element, rufen Sie flowplayer() auf ihn zusammen mit der gewünschten Methode. Zum Beispiel so:

jQuery('#your-element').flowplayer().play();

3. Wie verfolgen Nutzer, die das Video bis Ende beobachten mit Ajax

Hier ist ein Beispielcode für FV Player, der erkennt, ob der Benutzer wirklich das Video zu Ende angeschaut hat (Suchvorgang bis zum Ende wird nicht ausreichen) und sendet das Beitrag-ID via Ajax: https://gist.github.com/foliovision/2c266598333ecbd1f151

Video Dauer feststellen

Wie man beginnen

Zuerst müssen Sie die Integrationen > Video Dauer feststellen aktivieren. Aktivierung dieser Option stellt alle Ihre Beiträge mit Shortcode in eine Warteschlange, und dann ein cron scannt die Videos in dieser Beiträge und speichert die Video Dauer jedes Video.

Beitrag Speichern löst auch die Kontrolle

• Wenn ist das Video nicht richtig innerhalb dieser Zeit geprüft (schlechte Codierung, langsame Verbindung vom Server), dann ist es in den geplanten cron-Job Warteschlange eingestellt. So Sie könnten nicht sofort die Dauer aller Videos sehen.
• Die Video Dauer wird geprüft, nur einmal pro URL. Wenn Sie Ihr Video wesentlich ändern, erwarten wir, dass Sie auch den Dateinamen ändern.
• Wenn Sie es wirklich aktualisieren müssen, können Sie den _fv_flowplayer_% Meta-Tag für Ihr Post-ID von wp_postmeta Tabelle entfernen. Stellen Sie sicher, dass Sie Ihre Datenbank sichern, bevor Sie fortfahren, wenn Sie nicht wirklich gut SQL wissen. Dann deaktivieren / wieder aktivieren Sie die Integrationen > Video Dauer feststellen Option, um die Video Dauer Indizierung neu zu starten.

Welche Videos sind unterstützt?

Das Video muss richtig codiert und die moov Metadaten müssen am Anfang der Datei sein. Derzeit unterstützen wir dies nicht für RTMP oder HLS-Streams.

Wie zeigen der Video Dauer

Video Dauer kann festgelegt werden für:

1. Einzelne Videos
2. Wiedergabelisten

Die Zeit Dauer wird in CSS versteckt, um nicht normale Benutzer stören. Sie müssen CSS verwenden, um es sichtbar zu machen:

1. Einzelne Videos – .fvfp_duration { display: block }
2. Wiedergabelisten – .fp-playlist-external .dur { display: inline-block }

Sie können auch diesen folgenden PHP-Code verwenden um Dauer Ihres erstes Video in Beitrag Ihres Template zeigen:

echo flowplayer::get_duration_post($post_id)

Sie können auch diesen Shortcode verwenden um Dauer der vorherigen Video in der Beitrag zu zeigen.
Wenn Sie also mehrere shortcodes in der Beitrag haben, können Sie diese shortcodes nach jedem von ihnen setzen und es wird die Dauer zeigen.

[fv_time]