Điều khiển độ lớn bằng VolumeShaper

Bạn có thể sử dụng VolumeShaper trong ứng dụng âm thanh để thực hiện hiệu ứng tăng âm lượng, giảm âm lượng, chuyển âm lượng, giảm âm lượng và các hiệu ứng chuyển đổi âm lượng tự động ngắn khác. Lớp VolumeShaper có trong Android 8.0 (cấp độ API 26) trở lên.

Bạn tạo VolumeShaper bằng cách gọi createVolumeShaper() trên một thực thể của AudioTrack hoặc MediaPlayer. VolumeShaper chỉ hoạt động trên âm thanh do AudioTrack hoặc MediaPlayer tạo ra.

VolumeShaper.Configuration

Hành vi của VolumeShaper được xác định bằng VolumeShaper.Configuration. Cấu hình này chỉ định một *đường cong âm lượng, loại bộ nội suy và thời lượng.*

Đường cong âm lượng

Đường cong âm lượng thể hiện sự thay đổi biên độ theo thời gian. Đường cong này được xác định bằng một cặp mảng số thực, x[] và y[] xác định một loạt điểm điều khiển. Mỗi cặp (x, y) lần lượt biểu thị thời gian và âm lượng. Các mảng phải có độ dài bằng nhau và chứa ít nhất 2 và không quá 16 giá trị. (Độ dài đường cong tối đa được xác định trong getMaximumCurvePoints().)

Toạ độ thời gian được cung cấp trong khoảng [0,0, 1,0]. Thời điểm đầu tiên phải là 0,0, thời điểm cuối cùng phải là 1,0 và thời gian phải tăng dần.

Toạ độ âm lượng được chỉ định theo thang tuyến tính trong khoảng [0,0, 1,0].

Loại bộ nội suy

Đường cong âm lượng luôn đi qua các điểm điều khiển được chỉ định. Các giá trị giữa các điểm điều khiển được lấy từ một đường spline theo loại bộ nội suy của cấu hình. Có 4 hằng số cho các loại bộ nội suy VolumeShaper có sẵn:

  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_STEP
  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR
  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC
  • VolumeShaper.Configuration.INTERPOLATOR_TYPE_CUBIC_MONOTONIC

Thời lượng

Toạ độ thời gian được chỉ định trong khoảng [0.0, 1.0] được điều chỉnh theo thời lượng mà bạn chỉ định tính bằng mili giây. Điều này xác định độ dài thực tế theo thời gian của đường cong âm lượng khi bộ định hình đang chạy và áp dụng đường cong cho đầu ra âm thanh.

Sử dụng VolumeShaper

Tạo cấu hình

Trước khi tạo VolumeShaper, bạn phải tạo một thực thể của VolumeShaper.Configuration. Bạn có thể thực hiện việc này bằng cách sử dụng VolumeShaper.Configuration.Builder():

val config: VolumeShaper.Configuration = VolumeShaper.Configuration.Builder()
    .setDuration(3000)
    .setCurve(floatArrayOf(0f, 1f), floatArrayOf(0f, 1f))
    .setInterpolatorType(VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR)
    .build()

Nếu không có đối số, hàm khởi tạo VolumeShaper.Configuration.Builder sẽ trả về một trình tạo để tạo cấu hình có các chế độ cài đặt mặc định: INTERPOLATOR_TYPE_CUBIC, thời lượng một giây và không có đường cong. Bạn phải thêm một đường cong vào trình tạo trước khi gọi build().

Khung này cung cấp các hằng số cho cấu hình có đường cong tạo sẵn, mỗi đường cong có thời lượng một giây:

  • VolumeShaper.Configuration.LINEAR_RAMP
  • VolumeShaper.Configuration.CUBIC_RAMP
  • VolumeShaper.Configuration.SINE_RAMP
  • VolumeShaper.Configuration.SCURVE_RAMP

Tạo VolumeShaper

Để tạo VolumeShaper, hãy gọi createVolumeShaper() trên một thực thể của lớp thích hợp, truyền vào VolumeShaper.Configuration:

volumeShaper = myMediaPlayer.createVolumeShaper(config)
volumeShaper = myAudioTrack.createVolumeShaper(config)

Một bản nhạc hoặc trình phát nội dung nghe nhìn có thể có nhiều bộ định hình được đính kèm và bạn có thể kiểm soát riêng từng bộ định hình. Kết quả của tất cả các bộ định hình trên một bản nhạc hoặc trình phát được nhân với nhau. Không thể chia sẻ VolumeShaper giữa AudioTracks hoặc MediaPlayers, nhưng bạn có thể sử dụng cùng một cấu hình trong các lệnh gọi đến createVolumeShaper để tạo các trình định hình giống hệt nhau trên nhiều AudioTracks hoặc MediaPlayers.

Khi bạn tạo bộ định hình, điểm điều khiển đầu tiên (tại t = 0) sẽ được áp dụng cho luồng âm thanh. Nếu âm lượng ban đầu không phải là 1.0 và ứng dụng của bạn đang phát nội dung tại thời điểm tạo, thì âm thanh có thể thay đổi đột ngột về âm lượng. Phương pháp hay nhất là bắt đầu phát âm thanh từ trạng thái im lặng và sử dụng VolumeShaper để triển khai hiệu ứng tăng âm lượng khi bắt đầu phát. Tạo một VolumeShaper bắt đầu ở âm lượng 0 và tăng dần. Ví dụ:

setCurve(new float[] {0.f, 1.f}, new float[] {0.f, 1.f})

Bắt đầu phát và định hình cùng một lúc. Điều này đảm bảo rằng quá trình phát bắt đầu từ chế độ im lặng và âm lượng tăng dần đến mức tối đa. Điều này được giải thích trong phần tiếp theo.

Chạy VolumeShaper

Mặc dù mức âm lượng của điểm điều khiển đầu tiên được áp dụng cho đường dẫn âm thanh ngay khi trình định hình được tạo, nhưng trình định hình sẽ không tiến dọc theo đường cong cho đến khi bạn gọi phương thức apply() bằng VolumeShaper.Operation.PLAY. Sau khi tạo trình định hình, lệnh gọi đầu tiên của apply() phải chỉ định thao tác PLAY để khởi động trình định hình. Thao tác này sẽ chạy đường cong từ điểm điều khiển đầu tiên đến điểm điều khiển cuối cùng:

shaper.apply(VolumeShaper.Operation.PLAY)

Trong khi trình định hình đang chạy, bạn có thể đưa ra các lệnh gọi apply() luân phiên chỉ định các thao tác REVERSE và PLAY. Thao tác này sẽ thay đổi hướng đọc của các điểm điều khiển mỗi lần.

Bộ định hình liên tục điều chỉnh âm lượng và đi qua tất cả các điểm kiểm soát cho đến khi hết hạn. Điều này xảy ra khi trình định hình đạt đến điểm điều khiển cuối cùng (đối với thao tác PLAY) hoặc điểm điều khiển đầu tiên (đối với thao tác REVERSE) trong đường cong.

Khi bộ định hình hết hạn, âm lượng vẫn ở chế độ cài đặt gần đây nhất, có thể là điểm kiểm soát đầu tiên hoặc cuối cùng. Bạn có thể gọi VolumeShaper.getVolume() để biết mức âm lượng hiện tại bất cứ lúc nào.

Sau khi trình định hình hết hạn, bạn có thể đưa ra một lệnh gọi apply() khác để chạy đường cong theo hướng ngược lại. Ví dụ: nếu bộ định hình hết hạn trong khi chạy PLAY, thì apply() tiếp theo phải là REVERSE. Việc gọi PLAY sau khi PLAY đã hết hạn hoặc REVERSE sau khi REVERSE đã hết hạn sẽ không có hiệu lực.

Bạn phải luân phiên các thao tác PLAY và REVERSE. Không có cách nào để phát một đường cong từ điểm điều khiển đầu tiên đến điểm điều khiển cuối cùng rồi khởi động lại từ điểm điều khiển đầu tiên. Bạn có thể sử dụng phương thức replace() (được mô tả trong phần tiếp theo) để thay thế đường cong bằng một bản sao của chính nó. Thao tác này sẽ đặt lại trình định hình, yêu cầu thao tác PLAY để bắt đầu lại.

Thay đổi đường cong

Sử dụng phương thức replace() để thay đổi đường cong của VolumeShaper. Phương thức này lấy một cấu hình, một thao tác và một tham số kết hợp. Bạn có thể gọi phương thức replace() bất cứ lúc nào, trong khi trình định hình đang chạy hoặc sau khi hết hạn:

val newConfig = VolumeShaper.Configuration.Builder()
    .setDuration(1000)
    .setCurve(floatArrayOf(0f, 0.5f), floatArrayOf(0f, 1f))
    .setInterpolatorType(VolumeShaper.Configuration.INTERPOLATOR_TYPE_LINEAR)
    .build()
val join = true
shaper.replace(newConfig, VolumeShaper.Operation.PLAY, join)

Khi bạn gọi replace() trong khi trình định hình đang chạy, trình định hình sẽ ngừng thay đổi âm lượng và giữ nguyên giá trị hiện tại. Sau đó, trình định hình sẽ cố gắng bắt đầu đường cong mới từ điểm điều khiển đầu tiên. Điều này có nghĩa là đối số thao tác kiểm soát việc trình định hình có chạy sau lệnh gọi hay không. Chỉ định PLAY để bắt đầu ngay đường cong mới, chỉ định REVERSE để tạm dừng bộ định hình ở âm lượng của điểm điều khiển đầu tiên trong đường cong mới. Bạn có thể bắt đầu trình định hình sau bằng apply(VolumeShaper.Operation.PLAY).

Khi bạn gọi replace() bằng join = false, trình định hình sẽ bắt đầu đường cong ở cấp độ được chỉ định bởi điểm điều khiển đầu tiên. Điều này có thể gây ra sự gián đoạn về âm lượng. Bạn có thể tránh điều này bằng cách gọi replace() bằng join = true. Thao tác này sẽ đặt điểm kiểm soát đầu tiên của đường cong mới thành mức hiện tại của bộ định hình và điều chỉnh âm lượng của tất cả các điểm kiểm soát giữa điểm đầu tiên và điểm cuối cùng để duy trì hình dạng tương đối của đường cong mới (điểm kiểm soát cuối cùng không thay đổi). Thao tác điều chỉnh tỷ lệ sẽ thay đổi vĩnh viễn các điểm điều khiển trong đường cong mới của bộ định hình.

Xoá VolumeShaper

Hệ thống sẽ đóng và thu thập rác VolumeShaper khi AudioTrack hoặc MediaPlayer của nó được giải phóng hoặc không còn được sử dụng. Bạn có thể gọi phương thức close() trên một trình định hình để huỷ trình định hình đó ngay lập tức. Hệ thống sẽ xoá trình định hình khỏi quy trình âm thanh trong vòng khoảng 20 mili giây. Hãy cẩn thận khi đóng VolumeShaper trong khi âm thanh đang phát. Nếu trình định hình có âm lượng nhỏ hơn 1,0 khi bạn gọi close(), thì tỷ lệ âm lượng của trình định hình sẽ thay đổi thành 1,0. Điều này có thể khiến âm lượng tăng đột ngột.