Okay so to clarify, you can find general extension documentation here: CEP 6 HTML Extension Cookbook for CC 2015 · Adobe-CEP/CEP-Resources Wiki · GitHub
But as far as PPro specific bindings go, there is no documentation. You can see some simple uses in the example extension but no where does there exist a place to read about what the bindings are and how to use them.
Alec Koumjian wrote:
But as far as PPro specific bindings go, there is no documentation.
Correct, nor has there ever been any. This hasn't yet been a barrier for the dozens of panels created, so far.
Let us know if you have a specific question, not addressed by the sample code.
Okay, but let's be honest here, APIs without documentation are no fun. I don't really appreciate the attitude that it's an unreasonable thing to expect. I'm sure I can stumble my way through the functions I need to use, it's just not what I would expect from such a large software company.
I disagree—we find the PPro API quite fun.
In a previous Adobe life I wrote/maintained the After Effects SDK Guide, a >350-page behemoth FrameMaker publication with many thousands of manually hyper-linked cross-references, thorough overview sections in each chapter, version differences, and all available information one might need to write a plug-in...all of which everyone promptly ignored, and just asked me about the API.
Now, for PPro panel integration, I provide a working sample that exercises the important bits, and encourage people to ask us about the API. Any question we answer too often goes into the sample. And, as previously mentioned, the absence of documentation hasn't been a blocker.
We're happy to help; happier than you might expect from such a large software company.
The API is great and I'm glad it exists, thank you!
All most people ever really want is a high level overview of available methods with their input and output. Something in this vein: https://stripe.com/docs/api
Agreed, it's probably about time we offered something similar...
[I'll put you on the review list.]
Thanks. I'll guess I'll start with these questions:
- What, if any, parameters go into "$._ext_PPRO.replaceMedia()" ?
- Are the examples here the exhausted list of functions? Samples/index.html at master · Adobe-CEP/Samples · GitHub
1. None; see function definition on /PProPanel/jsx/Premiere.jsx, lline 283.
2. The examples there provide usage examples for most common functions.
Okay, now I am simply looking for general advice.
Let's say my app generates a download link to a proxy video file. What is the recommended way to fetch that file and insert it into the current project?
Would you use cep.process.createProcess to use a utility like curl to fetch the file?
I'm taking a look at this: Samples/Premiere.jsx at master · Adobe-CEP/Samples · GitHub
I'm not seeing where in the sample project the app or app.project objects are initialized, which would be a big help.
curl should work fine to download the file; you can use any mechanism you like.
Broadly, I'd download the proxy to the same directory as the project (or offer a download directory pref in your panel), and once download succeeds, use importFiles() to bring it into the project.