Monitor the Shaka player

1
import loadShakaPlayer from "@fastpix-shakaplayer";
2
import shaka from "shaka-player"; // Import Shaka Player
3
4
// Initialize player setup
5
const initTime = loadShakaPlayer.utilityMethods.now(); // Captures the exact timestamp of player initialization
6
const videoElement = document.getElementById("video-player"); // Select the HTML5 video element for Shaka Player
7
const player = new shaka.Player(videoElement); // Create a Shaka Player instance bound to the video element
8
9
// Define player metadata
10
const playerMetadata = {
11
    workspace_id: "WORKSPACE_KEY", // Mandatory field for FastPix integration, replace with your actual workspace key
12
    player_name: "PLAYER_NAME", // A unique identifier for this player instance (e.g., "MyVideoPlayer1")
13
    player_init_time: initTime, // The timestamp when the player was initialized, useful for analytics
14
    video_title: "VIDEO_TITLE", // The title of the video being played (e.g., "My Amazing Video")
15
    video_id: "VIDEO_ID", // Unique identifier for the video (e.g., from your CMS or database)
16
    viewer_id: "VIEWER_ID", // Unique identifier for the viewer
17
  
18
    // Additional metadata
19
};
20
21
// Configure FastPix data integration
22
const fastPixShakaIntegration = loadShakaPlayer(
23
    player, // The Shaka Player instance managing playback
24
    {
25
        debug: false, // Optional flag; set to true to enable debug logs for troubleshooting
26
        data: playerMetadata,
27
    },
28
    shaka // Pass the imported Shaka Player instance for proper integration
29
);
30
31
// Load the video content
32
const videoUrl = "https://stream.fastpix.com/027a90e4-f5e2-433d-81e5-b99ee864c3f6.m3u8"; // Replace with your video manifest URL
33
34
player
35
    .load(videoUrl) // Load the video manifest URL into the Shaka Player
36
    .then(() => {
37
        // Successfully loaded the manifest; FastPix will now begin tracking playback data
38
        console.log("Video manifest loaded successfully.");
39
    })
40
    .catch((error) => {
41
        // Handle errors that occur while loading the video manifest
42
        fastPixShakaIntegration.handleLoadError(error); // Notify FastPix of the error
43
        console.error("Error loading video manifest:", error); // Log the error for debugging
44
    });
45
46
// Use these methods to destroy fastpix data sdk and shakaplayer:
47
// player.destroy() - Destroys the Shaka Player
48
// player.fp.destroy() - Ends FastPix tracking

1
import loadShakaPlayer from "@fastpix-shakaplayer";
2
import shaka from "shaka-player"; // Import Shaka Player
3
4
// Initialize player setup
5
const initTime = loadShakaPlayer.utilityMethods.now(); // Captures the exact timestamp of player initialization
6
const videoElement = document.getElementById("video-player"); // Select the HTML5 video element for Shaka Player
7
const player = new shaka.Player(videoElement); // Create a Shaka Player instance bound to the video element
8
9
// Define player metadata
10
const playerMetadata = {
11
  workspace_id: "WORKSPACE_KEY", // Mandatory field for FastPix integration, replace with your actual workspace key
12
  player_name: "PLAYER_NAME", // A unique identifier for this player instance (e.g., "MyVideoPlayer1")
13
  player_init_time: initTime, // The timestamp when the player was initialized, useful for analytics
14
  video_title: "Test Content", // Title of the video being played (replace with the actual title of your video)
15
  video_id: "f01a98s76t90p88i67x", // A unique identifier for the video (replace with your actual video ID for tracking purposes)
16
  viewer_id: "user12345", // A unique identifier for the viewer (e.g., user ID, session ID, or any other unique value)
17
  video_content_type: "series", // Type of content being played (e.g., series, movie, etc.)
18
  video_stream_type: "on-demand", // Type of streaming (e.g., live, on-demand)
19
20
  // Custom fields for additional business logic
21
  custom_1: "", // Use this field to pass any additional data needed for your specific business logic
22
  custom_2: "", // Use this field to pass any additional data needed for your specific business logic
23
24
  // Additional metadata
25
};
26
27
// Configure FastPix data integration
28
const fastPixShakaIntegration = loadShakaPlayer(
29
  player, // The Shaka Player instance managing playback
30
  {
31
    debug: false, // Optional flag; set to true to enable debug logs for troubleshooting
32
    data: playerMetadata,
33
  },
34
  shaka, // Pass the imported Shaka Player instance for proper integration
35
);
36
37
// Load the video content
38
const videoUrl =
39
  "https://stream.fastpix.com/027a90e4-f5e2-433d-81e5-b99ee864c3f6.m3u8"; // Replace with your video manifest URL
40
41
player
42
  .load(videoUrl) // Load the video manifest URL into the Shaka Player
43
  .then(() => {
44
    // Successfully loaded the manifest; FastPix will now begin tracking playback data
45
    console.log("Video manifest loaded successfully.");
46
  })
47
  .catch((error) => {
48
    // Handle errors that occur while loading the video manifest
49
    fastPixShakaIntegration.handleLoadError(error); // Notify FastPix of the error
50
    console.error("Error loading video manifest:", error); // Log the error for debugging
51
  });

1
// player is the instance returned by `new shaka.Player`
2
const fastPixShakaIntegration = loadShakaPlayer(
3
  player, // The Shaka Player instance managing playback
4
  {
5
    debug: false, // Optional flag; set to true to enable debug logs for troubleshooting
6
    disableCookies: true, // Set to true to disable cookies for tracking sessions and unique viewers
7
    respectDoNotTrack: true, // Set to true to honor users' 'Do Not Track' preferences
8
    automaticErrorTracking: false, // Set to false to disable automatic tracking of fatal errors
9
    data: {
10
      workspace_id: "WORKSPACE_KEY", // Mandatory field for FastPix integration, replace with your actual workspace key
11
12
      // Additional metadata
13
    },
14
  },
15
  shaka, // Pass the imported Shaka Player instance
16
);

1
// player is the instance returned by `new shaka.Player` 
2
player.fp.dispatch("error", {
3
	player_error_code: 1008, // Custom error code  
4
	player_error_message: "Description of error", // Generalized error message  
5
	player_error_context: "Additional context for the error", // Instance-specific information  
6
});

1
// player is the instance returned by `new shaka.Player` 
2
player.fp.dispatch("videoChange", {
3
	video_id: "abc345", // Unique identifier for the new video 
4
	video_title: "My Other Great Video", // Title of the new video 
5
	video_series: "Weekly Great Videos", // Series name if applicable 
6
	
7
  	// ... and other metadata 
8
});

1
import loadShakaPlayer from "@fastpix-shakaplayer";
2
import shaka from "shaka-player"; // Import Shaka Player
3
4
// Initialize player setup
5
const initTime = loadShakaPlayer.utilityMethods.now(); // Captures the player initialization time
6
const videoElement = document.getElementById("video-player"); // HTML5 video element for Shaka Player
7
const player = new shaka.Player(videoElement); // Shaka Player instance bound to the video element
8
9
// Define player metadata
10
const playerMetadata = {
11
  workspace_id: "WORKSPACE_KEY", // Replace with your workspace key
12
  player_name: "PLAYER_NAME", // A unique identifier for the player instance
13
  player_init_time: initTime, // The time the player was initialized
14
  video_title: "VIDEO_TITLE", // Title of the video being played for analytics
15
  video_id: "VIDEO_ID", // Unique identifier for the video
16
  viewer_id: "VIEWER_ID", // Unique identifier for the viewer
17
18
  // Additional metadata can be added here
19
};
20
21
// Configure FastPix data integration
22
const fastPixShakaIntegration = loadShakaPlayer(
23
  player,
24
  {
25
    debug: false, // Set to true to enable debug logs
26
    data: playerMetadata, // Pass metadata object
27
  },
28
  shaka, // The Shaka Player instance (mandatory field)
29
);
30
31
// Load the video content
32
const videoUrl =
33
  "https://stream.fastpix.com/027a90e4-f5e2-433d-81e5-b99ee864c3f6.m3u8"; // Replace with your video manifest URL
34
35
player
36
  .load(videoUrl) // Load the video manifest into the Shaka Player
37
  .then(() => {
38
    // Successfully loaded the manifest. FastPix data will begin tracking.
39
  })
40
  .catch((error) => {
41
    fastPixShakaIntegration.handleLoadError(error);
42
  });