@pbvision/partner-sdk 0.1.11 → 0.1.12

package/README.md

@@ -22,10 +22,10 @@ standard length game, so we'll notify your servers when the results are ready.
 
 ### Step 1: Get API Access
 
-Email **[dev@pb.vision](mailto:dev@pb.vision)** to request API access for your
+Email **[support@pb.vision](mailto:support@pb.vision)** to request API access for your
 account. Let us know which data you need access to (e.g. insights, stats) which
 is documented below in the [Callback Data](#callback-data) section. We'll send
-you an API Key after discussing your needs more in depth.
+you an API Key after discussing your needs more in depth and laying out our billing options.
 
 ### Step 2: SDK Setup
 
@@ -79,12 +79,11 @@ Next, tell us to download and work on the video. You can do this using our SDK:
 ```javascript
 import { PBVision } from '@pbvision/partner-sdk';
 
-const pbv = new PBVision(YOUR_API_KEY);
+const pbv = new PBVision(YOUR_API_KEY, { useProdServer: true });
 // you can omit this metadata, or provide some or all of this object—whatever you'd like!
 const optionalMetadata = {
-  userEmails: [],
-  name: 'Dink Championship 2024',
-  desc: 'A longer description, if you want',
+  userEmails: [], // these users will have the video in their PB Vision library
+  name: 'Dink Championship 2025',
   gameStartEpoch: 1711393200, // when the game was played
 };
 await pbv.sendVideoUrlToDownload(YOUR_VIDEO_URL, optionalMetadata);
@@ -107,12 +106,11 @@ You can directly upload your video from a file using the SDK too:
 ```javascript
 import { PBVision } from '@pbvision/partner-sdk';
 
-const pbv = new PBVision(YOUR_API_KEY, { useProdServer: false });
+const pbv = new PBVision(YOUR_API_KEY, { useProdServer: true });
 // you can omit this metadata, or provide some or all of this object—whatever you'd like!
 const optionalMetadata = {
-  userEmails: [],
-  name: 'Dink Championship 2024',
-  desc: 'A longer description, if you want',
+  userEmails: [], // these users will have the video in their PB Vision library
+  name: 'Dink Championship 2025',
   gameStartEpoch: 1711393200, // when the game was played
 };
 await pbv.uploadVideo(YOUR_VIDEO_FILENAME, optionalMetadata);
@@ -121,8 +119,8 @@ await pbv.uploadVideo(YOUR_VIDEO_FILENAME, optionalMetadata);
 ### Video Editors
 
 Editors can tag themselves and friends in the video. They also have access to
-the video even if the video is private (to make uploaded by your partner
-account private by default, please email us).
+the video even if the video is private (to make videos uploaded by your partner
+account private by default, please let us know via email).
 
 You can get the current list of editors on a video by using the `getVideoEditors()`
 method. Similarly, the `setVideoEditors()` method can be used to change the
@@ -145,8 +143,7 @@ data is enabled for your API key, only some of these fields may be present):
 ```json
 {
     "from_url": "https://example.com/my-video.mp4",
-    "webpage": "https://pb.vision/video/tvgz3pqij0ll",
-    "cutVideo": "https://storage.googleapis.com/pbv-pro/xyz/f50272db-69a8-49ed-9d92-3a4d067af87c/rallies.mp4",
+    "webpage": "https://pb.vision/video/83gyqyc10y8f",
     "cv": CV_DATA,
     "insights": INSIGHTS_DATA,
     "stats": STATS_DATA,
@@ -170,7 +167,6 @@ data is enabled for your API key, only some of these fields may be present):
 - `stats` various stats about the game for advanced players
   - Explore the _stats_ schema at <https://pbv-public.github.io/stats?s=~stats~game>
   - Schema changes and diffs are in our [`pbv-public/stats` repo](https://github.com/pbv-public/stats/blob/dev/CHANGELOG.md)
-- `cutVideo` contains a link to the rally-sliced (dead time removed) .mp4.
 - only included if `insights` is included:
   - `vid` - the unique ID of the video in our system
   - `aiEngineVersion` - the version number of our AI used to process the video
@@ -191,7 +187,7 @@ For best results, we also recommend:
 - Audio Encoding: MPEG-4 AAC
 - Resolution: 1080p
 - Frame Rate: 30 FPS
-- Max Bitrate: 2 Mbps
+- Max Bitrate: 4 Mbps
 - Max File Size: 2GB
 
 ## Reference Guide

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pbvision/partner-sdk",
   "description": "SDK for interacting with the PB Vision pickleball AI engine.",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "license": "MIT",
   "type": "module",
   "engines": {

package/src/index.js

@@ -140,7 +140,8 @@ export class PBVision {
   async uploadVideo (mp4Filename, { userEmails = [], name, desc, gameStartEpoch, facility, court, fid } = {}) {
     const pieces = mp4Filename.split('.')
     const ext = pieces[pieces.length - 1]
-    const makeVIDResp = await this.__callAPI('make_video_id', { userEmails, name, desc, gameStartEpoch, facility, court, fid, fileExt: ext })
+    const platform = { name: 'api', version: '0.1.12' }
+    const makeVIDResp = await this.__callAPI('make_video_id', { platform, userEmails, name, desc, gameStartEpoch, facility, court, fid, fileExt: ext })
     const { hasCredits, vid } = JSON.parse(makeVIDResp)
     if (hasCredits === false) {
       return { hasCredits }