AppleScript and Numbers: Audio Clips

Audio Clips

The terminology of the Numbers dictionary includes an audio clip class and properties for controlling its use:

The iWork Suite audio clip Class

audio clip n [inh. iWork item ] : An audio clip

elements

contained by slides, document.

properties

clip volume ( integer ) : The volume setting for the audio clip, from 0 (none) to 100 (full volume).

file name ( text r/o) : The name of the audio file.

repetition method ( none/‌loop/‌loop back and forth ) : If or how the audio clip repeats.

responds to

delete, exists

NOTE: In the current version of Numbers the audio clip class does not support the use of the make command. See the script example below for details on how to import an audio clip.

Import an Audio Clip

tell application "Numbers"

activate

try

-- PROMPT USER TO PICK AUDIO CLIP FILE

set audioFileHFSAlias to ¬

(choose file of type "public.audio" with prompt ¬

"Select the audio clip file to import:" default location (path to music folder))

-- CREATE DOCUMENT IF ONE DOES NOT EXIST

if not (exists document 1) then

make new document with properties ¬

{document template:template "Blank"}

end if

tell document 1

-- IMPORT MOVIE FILE TO ACTIVE SHEET

tell the active sheet

-- Numbers does not support using the audio clip class with the make verb

-- Import the audio clip file by using the image class as the direct parameter

-- The returned object reference will be to the created audio clip item

set thisAudioClip to make new image with properties {file:audioFileHFSAlias}

--> audio clip 1 of sheet 1 of document "Document Name"

-- ADJUST MOVIE PROPERTIES

tell thisAudioClip

-- adjust the size and position of the movie item...

-- using properties inherited from iWork Item class

set position to {0, 0}

-- audio file class properties

set clip volume to 90

set repetition method to none

-- place the locked property at the end because

-- you can't change the properties of a locked iWork item

set locked to true

end tell

on error errorMessage number errorNumber

if errorNumber is not -128 then

display alert ("ERROR " & errorNumber as string) message errorMessage

end if

end try

end tell

Protected Audio Files

iWork applications do not allow the import of copy-protected media files. Attempting to import such items may cause an error.

TOP | CONTINUE

DISCLAIMER

THIS WEBSITE IS NOT HOSTED BY APPLE INC.

Mention of third-party websites and products is for informational purposes only and constitutes neither an endorsement nor a recommendation. MACOSXAUTOMATION.COM assumes no responsibility with regard to the selection, performance or use of information or products found at third-party websites. MACOSXAUTOMATION.COM provides this only as a convenience to our users. MACOSXAUTOMATION.COM has not tested the information found on these sites and makes no representations regarding its accuracy or reliability. There are risks inherent in the use of any information or products found on the Internet, and MACOSXAUTOMATION.COM assumes no responsibility in this regard. Please understand that a third-party site is independent from MACOSXAUTOMATION.COM and that MACOSXAUTOMATION.COM has no control over the content on that website. Please contact the vendor for additional information.