Audio File Import?

[andrewmoore-nz]

Is someone able to provide some more documentation or examples for using the import functionality of the SDK? Looking at the documentation/code, it's very unclear as to what the intended process is.

When trying to import a file with the following request:

ImportRequest request;
request.commandType = CommandType::Import;
request.importType = ImportType::Audio;
request.audioOptions = AudioMediaOptions::CopyFromSource;
request.filesList = {"/path/to/file.wav"};
request.audioOperations = AudioOperations::Copy;
request.destinationPath = "/path/to/destination/"; // What does this actually do?
request.destination = MediaDestination::NewTrack;
request.location = MediaLocation::SessionStart;

The response returns with a command status of Completed, with no error, however nothing has happened in Pro Tools. Additionally, the values in the response object do not match the request, in that the fileList vector is empty, the audioOperations is Add, and the destinationPath is an empty string. It seems as if it's completely ignoring the request that I'm making.

It's a rather difficult to tell at the moment what aspects of the SDK are simply not functional/broken versus not implemented e.g. looking at CppPTSLC_Import.cpp, there is only a case for ptsl::ImportType::Audio, so does this mean that the other ImportType cases (ClipGroups, MIDI, Video) are not functional yet?

[rmajors]

Thanks for reporting this. The audio type parameter for the Import function is not yet implemented. Only session import is currently supported. We hope to add support for importing individual audio files in the future.

We will work on improving the documentation for which items are not yet supported.

[jaydeesm]

I admit I spent an hour unsuccessfully and gave up to those with more patience than me!

Would relative paths to the audio files folder be supported as an option? ./file.wav

How are we to know when SDK updates happen? Here?

[jaydeesm]

And please, please, please some way when it comes to spotting onto a track to use a bitmask to say here is 10 channel interleaved audio file, but only use channels 3 and 5 on this stereo track.

That has been our number one request since, well... since protools supported interleaved audio!

So many customer's have polywave files for dialog and just want to bring in 2 or 3 or 1 channel, but use the original source file so they can pull out other mics if they want.

The way it works now is I can send the original file in, but just the first(or is it the last), channel pops on the track(assuming a mono track)

[rmajors]

We are discussing these feature requests internally. I'll let you know when we have more information.

How are we to know when SDK updates happen? Here?

Yes, we will post an announcement in this form for each update to the SDK. SDK updates will usually correspond to new Pro Tools versions.

[rmajors]

I have logged these feature requests and have discussed them with the team. Due to other important scripting features in the pipeline we have no immediate plans to support either relative paths or spotting subsets of channels from multichannel wav files. Here are the IDs for each feature request in our system:

PT-297769 Enhance Spot command with a way to spot a subset of channels out of a multichannel file

PT-297770 Support relative paths for ImportAudio

[jaydeesm]

What about getting attributes of selected item(s). The source file path, the region in and out points(in fractional seconds?), samplerate, the # of samples past midnight the sound is on the timeline?

[rmajors]

We don't currently have any plans to add information about objects in the current timeline selection, but we have added this request to our list of requested features as PT-298198.

[swappl]

Originally Posted by rmajors

I have logged these feature requests and have discussed them with the team. Due to other important scripting features in the pipeline we have no immediate plans to support either relative paths or spotting subsets of channels from multichannel wav files. Here are the IDs for each feature request in our system:

PT-297769 Enhance Spot command with a way to spot a subset of channels out of a multichannel file

PT-297770 Support relative paths for ImportAudio

Hello Rob,

we have the same problem with importing audio and video files that Andrew initially posted.

I have some questions:

1. Is there a way to track the status of tickets?
2. When will there be an update of the SDK?
3. In the current version, is there a way to find out what error occurred in Pro Tools when the API simply returns "status: Completed / progress: 100"?

Thanks,
Steffen

[rmajors]

We will include lists of fixed issues and known outstanding issues in each update to the SDK. You can also ask about particular issues here on the forum.

For now, we expect to release an update to the SDK corresponding to each Pro Tools release. The actual availability of the new SDK may come before or after the corresponding Pro Tools software, but they should track pretty closely. We expect that most updates will involve fixes and changes on both the SDK side and the Pro Tools host software side.

In the current version, is there a way to find out what error occurred in Pro Tools when the API simply returns "status: Completed / progress: 100"?

We are looking into this and will get back to you with more information.