Ionic - Cordova Media
Plugin này cho phép chúng tôi ghi và phát lại các tệp âm thanh trên thiết bị.
Sử dụng phương tiện
Như với tất cả các plugin Cordova khác, điều đầu tiên chúng ta cần làm là cài đặt nó từ cửa sổ nhắc lệnh.
C:\Users\Username\Desktop\MyApp>cordova plugin add cordova-plugin-media
Bây giờ, chúng tôi đã sẵn sàng để sử dụng plugin. Trong mẫu mã sau,srclà tệp mp3 nguồn mà chúng tôi sẽ sử dụng cho hướng dẫn này. Nó được đặt trongjs thư mục, nhưng chúng ta cần thêm /android_asset/www/ trước nó, vì vậy nó có thể được sử dụng trên các thiết bị Android.
Chức năng hoàn chỉnh được bao bọc bên trong $ionicPlatform.ready()chức năng để đảm bảo rằng mọi thứ được tải trước khi plugin được sử dụng. Sau đó, chúng tôi đang tạomedia đối tượng bằng cách sử dụng newMedia(src)phương pháp. Cácmedia đối tượng được sử dụng để thêm các chức năng phát, tạm dừng, dừng và giải phóng.
Mã điều khiển
.controller('MyCtrl', function($scope, $ionicPlatform, $cordovaMedia) {
$ionicPlatform.ready(function() {
var src = "/android_asset/www/js/song.mp3";
var media = $cordovaMedia.newMedia(src);
$scope.playMedia = function() {
media.play();
};
$scope.pauseMedia = function() {
media.pause();
};
$scope.stopMedia = function() {
media.stop();
};
$scope.$on('destroy', function() {
media.release();
});
});
}
Chúng tôi cũng sẽ tạo ba nút để gọi các chức năng phát, tạm dừng và dừng.
<button class = "button" ng-click = "playMedia()">PLAY</button>
<button class = "button" ng-click = "pauseMedia()">PAUSE</button>
<button class = "button" ng-click = "stopMedia()">STOP</button>
Chúng tôi cần chạy nó trên trình giả lập hoặc thiết bị di động để plugin này hoạt động. Khi người dùng nhấn vào nút phát,song.mp3 sẽ bắt đầu chơi.
Bạn có thể thấy trong ví dụ trên mà chúng tôi sử dụng srcnhư một tham số tùy chọn. Có các tham số tùy chọn khác có thể được sử dụng chonewMedia phương pháp.
Các thông số tùy chọn
Bảng sau sẽ hiển thị tất cả các thông số tùy chọn có sẵn.
Tham số | Kiểu | Chi tiết |
---|---|---|
mediaSuccess | chức năng | Được gọi sau khi hành động phát / ghi hoặc dừng hiện tại đã hoàn thành. |
mediaError | chức năng | Được gọi khi có lỗi. |
mediaStatus | chức năng | Được mời để hiển thị các thay đổi trạng thái. |
Bảng tiếp theo sẽ hiển thị tất cả các phương pháp có sẵn.
Các phương pháp có sẵn
Bảng sau sẽ hiển thị tất cả các phương pháp có sẵn.
phương pháp | Thông số | Chi tiết |
---|---|---|
newMedia (tham số1) | src | Trả về đối tượng phương tiện sẽ được sử dụng cho các phương thức trong tương lai. src là một URI của nội dung âm thanh. |
getCurrentPosition | / | Trả về vị trí hiện tại trong tệp âm thanh. |
getDuration | / | Trả về thời lượng của tệp âm thanh. |
chơi | / | Được sử dụng để bắt đầu hoặc tiếp tục chơi. |
tạm ngừng | / | Được sử dụng để tạm dừng phát lại. |
dừng lại | / | Dùng để ngừng chơi. |
giải phóng | / | Được sử dụng để giải phóng tài nguyên âm thanh. |
seekTo (tham số1) | mili giây | Được sử dụng để đặt vị trí phát lại tính bằng mili giây. |
setVolume (tham số1) | âm lượng | Dùng để thay đổi âm lượng. Phạm vi từ 0 đến 1 |
startRecord () | / | Dùng để bắt đầu ghi. |
stopRecord | / | Dùng để dừng ghi. |