video_meta()

nebula()->video_meta($provider, $id)

        public function video_meta($provider, $id){
            $override = apply_filters('pre_video_meta', null, $provider, $id);
            if ( isset($override) ){return $override;}

            $timer_name = $this->timer('Video Meta (' . $id . ')', 'start', '[Nebula] Videos');

            //Ensure these default keys are always available
            $video_metadata = array(
                'origin' => $this->url_components('basedomain'),
                'id' => $id,
                'error' => false,
                'title' => 'unknown_title',
                'safetitle' => 'unknown_title'
            );

            if ( !empty($provider) ){
                $provider = strtolower($provider);
            } else {
                $video_metadata['error'] = 'Video provider is required.';
                $this->timer($timer_name, 'end');
                return $video_metadata;
            }

            //Get Transients
            $video_json = nebula()->transient('nebula_' . $provider . '_' . $id, function($data){
                if ( $data['provider'] === 'youtube' ){
                    if ( !$this->get_option('google_server_api_key') && $this->is_staff() ){
                        trigger_error('No Google Youtube Iframe API key. Youtube videos may not be tracked!', E_USER_WARNING);
                        echo '<script>console.warn("No Google Youtube Iframe API key. Youtube videos may not be tracked!");</script>';
                        $video_metadata['error'] = 'No Google Youtube Iframe API key.';
                    }

                    $response = $this->remote_get('https://www.googleapis.com/youtube/v3/videos?id=' . $data['id'] . '&part=snippet,contentDetails,statistics&key=' . $this->get_option('google_server_api_key', ''));
                    if ( is_wp_error($response) ){
                        trigger_error('Youtube video is unavailable.', E_USER_WARNING);
                        $video_metadata['error'] = 'Youtube video is unavailable.';
                        $this->timer($data['timer_name'], 'end');
                        return $video_metadata;
                    }

                    $video_json = $response['body'];
                } elseif ( $data['provider'] === 'vimeo' ){
                    $response = $this->remote_get('http://vimeo.com/api/v2/video/' . $data['id'] . '.json');
                    if ( is_wp_error($response) ){
                        trigger_error('Vimeo video is unavailable.', E_USER_WARNING);
                        $video_metadata['error'] = 'Vimeo video is unavailable.';
                        $this->timer($data['timer_name'], 'end');
                        return $video_metadata;
                    }

                    $video_json = $response['body'];
                }

                return $video_json;
            }, array('provider' => $provider, 'id' => $id, 'timer_name' => $timer_name), HOUR_IN_SECONDS*12);

            if ( !is_array($video_json) ){ //If it is not already an array, decode it from the JSON string
                $video_json = json_decode($video_json);
            }

            //Check for errors
            if ( empty($video_json) ){
                if ( current_user_can('manage_options') || $this->is_dev() ){
                    if ( $provider === 'youtube' ){
                        $video_metadata['error'] = 'A Youtube Data API error occurred. Make sure the Youtube Data API is enabled in the Google Developer Console and the server key is saved in Nebula Options.';
                    } else {
                        $video_metadata['error'] = 'A Vimeo API error occurred (A video with ID ' . $id . ' may not exist). Tracking will not be possible.';
                    }
                }
                $this->timer($timer_name, 'end');
                return $video_metadata;
            } elseif ( $provider === 'youtube' && !empty($video_json->error) ){
                if ( current_user_can('manage_options') || $this->is_dev() ){
                    $video_metadata['error'] = 'Youtube API Error: ' . $video_json->error->message;
                }
                $this->timer($timer_name, 'end');
                return $video_metadata;
            } elseif ( $provider === 'youtube' && empty($video_json->items) ){
                if ( current_user_can('manage_options') || $this->is_dev() ){
                    $video_metadata['error'] = 'A Youtube video with ID ' . $id . ' does not exist.';
                }
                $this->timer($timer_name, 'end');
                return $video_metadata;
            } elseif ( $provider === 'vimeo' && is_array($video_json) && empty($video_json[0]) ){
                $video_metadata['error'] = 'A Vimeo video with ID ' . $id . ' does not exist.';
            }

            //Build Data
            if ( $provider === 'youtube' ){
                $video_metadata['raw'] = $video_json->items[0];
                $video_metadata['title'] = $video_json->items[0]->snippet->title;
                $video_metadata['safetitle'] = preg_replace('/(\W)/i', '', $video_json->items[0]->snippet->title);
                $video_metadata['description'] = $video_json->items[0]->snippet->description;
                $video_metadata['thumbnail'] = $video_json->items[0]->snippet->thumbnails->high->url;
                $video_metadata['author'] = $video_json->items[0]->snippet->channelTitle;
                $video_metadata['date'] = $video_json->items[0]->snippet->publishedAt;
                $video_metadata['url'] = 'https://www.youtube.com/watch?v=' . $id;
                $start = new DateTime('@0'); //Unix epoch
                $start->add(new DateInterval($video_json->items[0]->contentDetails->duration));
                $duration_seconds = intval($start->format('H'))*60*60 + intval($start->format('i'))*60 + intval($start->format('s'));
            } elseif ( $provider === 'vimeo' ){
                $video_metadata['raw'] = $video_json[0];
                $video_metadata['title'] = $video_json[0]->title;
                $video_metadata['safetitle'] = preg_replace('/(\W)/i', '', $video_json[0]->title);
                $video_metadata['description'] = $video_json[0]->description;
                $video_metadata['thumbnail'] = $video_json[0]->thumbnail_large;
                $video_metadata['author'] = $video_json[0]->user_name;
                $video_metadata['date'] = $video_json[0]->upload_date;
                $video_metadata['url'] = $video_json[0]->url;
                $duration_seconds = strval($video_json[0]->duration);
            }
            $video_metadata['duration'] = array(
                'time' => intval(gmdate("i", $duration_seconds)) . gmdate(":s", $duration_seconds),
                'seconds' => $duration_seconds
            );

            $this->timer($timer_name, 'end');
            return $video_metadata;
        }

add_filter('pre_video_meta', 'my_custom_video_meta', 10, 3); //The last integer must be 1 more than the actual parameters
function my_custom_video_meta($null, $provider, $id){ //$null is required, but can be ignored
    //Write your own code here

    return true; //Return true to prevent the original function from running afterwords
}

 add_filter('pre_video_meta', '__return_false');